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1.1 INTRODUCTION 



and program loading 



1.1.1 Manual Contents 

This manual contains information on data management 
facilities available in the VERSAdos operating system. 

Chapters 1, 2, 3, and 4 describe: 

Device names and file descriptors 

Disk, file, and record structures 

File access methods 

File and device protection 

Temporary and spool e,r files 

File Handling Services (FHS) module 

Input/Output Services (lOS) module 

Supported devices 

Chapter 5, "PROGRAM LOADER", shows how any task can call the loader to 
transfer a load module into memory and create a new task. The parameter block 
required for calling the loader, by executing a TRAP #4, is also described. 

1.1.2 Notation 

In this manual, commands and other Input/Output (I/O) are presented in a 
modified Backus-Naur Form (BNF). Certain symbols in the syntax may be used 
where noted in the real I/O; however, others are meta-symbols whose meanings 
are: 



< > 

[ ] 
[ ]... 



Angle brackets enclose a word referred to as a syntactic 
variable that is replaced in a command line by one of a class of 
items it represents. 



Square brackets enclose an item that is optional, 
item may occur zero or one time. 



The enclosed 



Square brackets followed by periods enclose an item that is 
optional/repetitive. The item may appear zero or more times. 



Operator inputs are followed by a carriage return. The carriage return is 
shown as (CR) if it is the only input required. In some examples, operator 
inputs are underscored for clarity. The underscore is not typed. 
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1.1.3 Related Documentation 

The following publications may provide additional helpful information. If not 
shipped with this product, they may be obtained from Motorola's Literature 
Distribution Center, 616 West 24th Street, Tempe, Az 85282; telephone (602) 
994-6561. 



DOCUMENT TITLE 



MOTOROLA 
PUBLICATION NUMBER 



M58000 CRT Text Editor User's Manual 

M68000 Family Real-Time Multitasking Software 
User's Manual 

System Generation Facility User's Manual 

VERSAdos Messages Reference Manual 

J/ERSAdos Overview 

M68000 Family VERSAdos System Facilities 
Reference Manual 

VERSAdos to VME Hardware and Software Configuration 
User's Manual 

Guide to Writing Device Drivers for VERSAdos 



M68KEDIT 
M68KRMS68K 

M68KSYSGEN 
M68KVMSG 
M68KV0VER 
M68KVSF 

MVMEVDOS 

M68KDRVGD 



1.2 INPUT/OUTPUT SERVICES OVERVIEW 

Because the VERSAdos I/O system handles logical I/O rather than physical 
hardware I/O, the VERSAdos system I/O is device independent. Most I/O 
operations refer only to logical properties (e.g., the next record), rather 
than to particular device characteristics or file formats. VERSAdos- 
supported hardware I/O is performed by routines not directly accessible to a 
user task. 

To help control the sources and targets for I/O, the system uses a software 
feature called a logical unit assignment. An assignment is similar to a 
numbered channel; it controls the flow of data between program accessible 
storage and devices/files. Before any I/O operations can occur, file 
assignment must be made. The assignment specifies a Logical Unit Number (LUN) 
and target (file or device) as well as the type of channel connection required 
(e.g., exclusive read and write). Paragraph 2.3.2 describes the Assignment 
facility in detail . 



A file's assignment type governs which I/O calls are allowed. For example, 
rename a file requires an Exclusive Read-Write (EREW) assignment. 



to 
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All I/O is separated into two categories: 

lOS call Executed via a TRAP #2 instruction. 



n 



FHS call 



Executed via a TRAP #3 instruction. 



FILE HANDLING SERVICES (FHS) 



Allocate 

Assign 

Change-Access -Permission 

Rename 

Protect 

Delete 

Checkpoint 

Close 

Retrieve- Attributes 

Fetch-Directory-Entry 

Fetch-Device-Mnemonics 

Change- LUN-Assignment 

Fetch-Def aul t-Vol ume 

Cancel 

Continue 

Forms 

Print 

Copies 

Queue 

INPUT/OUTPUT SERVICES flOSl 

Read 
Write 

Connect ion-Wait -I/O 
Proceed-Wait-I/0 
Output-with-Input 
Update-Record 
Delete-Record 
Format 
Position 
Rewind 
Halt- I/O 

Test-I/O-Complete 
Wait-Only 

Local -Break-Cl aimer 
Transmit-Break 
Negate-Local-Break- 
Claimer 
Configure-Device 
Configure-Defaults 

Configuration -Status 



Create a file on a random access device 

Establish a logical connection 

Change access permission of a file or device 

Change a file ID 

Change access privileges 

Delete a file 

Update a file on disk 

Dissolve an assignment 

Get device/file attributes 

Get directory entries 

Get device/volume IDs 

Switch LUN assignment 

Retrieve system or user default volume 

Cancel a spooler job 

Continue a spooler output 

Change forms ID 

Add/change a spooler job 

Change number of copies for a spooler job 

Output the spooler queue listing 



Read from a file/device 

Write to a file/device 

Suspend task until device is free 

Return control to the calling task 

Write to then read from a device 

Update a record 

Delete a record 

Format a disk/sector 

Position to a particular record of a file 

Position at beginning of file 

Terminate outstanding I/O 

Test I/O completion 

Wait only 

Request an attention event for a break condition 

Send break to LUN specified 

Release from break service 



Set device-specific configuration 
Change device-specific parameters 
SYSGEN 
Return device configuration 



assigned at 
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The FHS module provides the logical link to a file via a Logical Unit Number 
(LUN). The FHS module is also called whenever a logical link is changed or 
dissolved. In addition, the FHS module is called to create a disk file and 
whenever the target attributes need to be changed (i.e., change access 
permission) for file or device assignments. 

All data transfers are handled by calling the lOS module. The logical unit 
connection between the task and the physical device must have been made with 
the Assign (FHS) request before invoking lOS with a TRAP #2 (refer to 
paragraph 2.3.2) . 

1,3 FILE AND DEVICE NAME SPECIFICATION 

A VERSAdos disk file description consists of five fields: 

a. Volume ID A string of one to four alphanumeric characters, the 

first of which must be alphabetic. It is the name of 
the volume on which the file resides. 

b. User number A 2-byte binary number with a value of: 

1 to 65533 Indicates a private user file. 

Indicates a system file. 

Paragraph 2.2.5 describes the user number concept. 

c. Catalog name A string of one to eight alphanumeric characters, the 

first of which must be alphabetic. Any spaces must be 
trailing spaces. A null catalog (all spaces) is a 
valid catalog name. Refer to paragraph 2.2.6. 

d. Filename A string of one to eight alphanumeric characters, the 

first of which must be alphabetic. Any spaces must be 
trailing spaces. This is the main identifier for the 
file and the choice of name is at the discretion of 
the user. Refer to paragraph 2.2.7. 

e. Extension A string of one to two alphanumeric characters, the 

first of which must be alphabetic. The extension 
usually denotes the type of data in the file and can 
be anything the user chooses. However, the VERSAdos 
operating system and utilities use some default 
extensions: 
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AF Chain files (assembly of source modules) 

AG Source files (assembled at SYSGEN) 

AI INCLUDE files (not assembled at SYSGEN) 

CD SYSGEN command files 

CF Chain file 

CI Included SYSGEN command file 

DB SYMbug debug files from linker 

EM Emulator module files for SYMbug/A and HDS 

EQ Equate files 

FF FORTRAN compilation chain files 

HT Copyright and Restricted Rights Legend files 

IN Initialization files 

LF Chain files for linking RO modules 

LG Link chain files (run at SYSGEN) 

LL Output listing files from a linkage 

LO Load modules output from linking 

LS Output listing files from an assembly 

MC INCLUDE files (assembler MACRO source) 

MG Merge files (insert into existing files) 

MX S-Record format files 

NW News files 

OW Owner files (session management) 

PC Pascal intermediate code files 

PF Pascal compilation (chain or profile files) 

PL Pascal phase 1 listing files 

PO Optimized Pascal code files 

RO Relocatable object modules 

RS Symbolic debug files (from ASM for linker) 

SA Source ASCII files 

SI INCLUDE files (assemblies done at SYSGEN) 

SY System related files 

TF Temporary files 

Other extensions are defined as required. 

File descriptors are written as: 

<voln>:<user>.<catalog>.<filename>.<ext> 

where: 

<voln> is the volume ID. 

<user> is the user number. 

<catalog> is the catalog name. 

<filename> is the filename. 

<ext> is the extension. 

A file description can also describe a device, in which case <voln> describes 
a device mnemonic rather than a volume ID. At initialization time, each 
device in the system is assigned a device mnemonic of up to four characters. 

The format for specifying a device mnemonic is: 

# <dev> 



MICROSYSTEMS 



D 



(^ MOTOROLA 

D 



DATA MANAGEMENT FACILITIES 



No volume ID may match any device mnemonic within a single system. Each 
device mnemonic defined for a single system must be unique. 



For a complete description of command level syntax, refer to the M68000 Family 
VERSAdos System Facilities Reference Manual. 

1.3.1 Default Values 

FHS handles default values for the system volume ID or user default volume ID 
and user number only. The session manager handles other defaults. (Refer to 
the M68000 Family VERSAdos System Facilities Reference Manual.) The volume ID 
has several default values, depending on the type of file specified. To 
indicate that the default should be used, set the volume ID field to spaces 
($20). 

The volume ID system default value is established when the system 
administrator initializes the system. When user session management creates a 
session at user logon, user default values are established for volume ID, user 
number, and catalog. 

The user number must be specified at user logon; volume ID and catalog may 
also be specified. If volume ID and catalog are not specified, the system 
volume ID is used as the default user volume ID, and the default user catalog 
is set to all spaces. A user can change the user default values during a 
session with the USE command. 

When the system administrator (user number = 0) omits the volume ID in 
specifying a file, the volume ID first defaults to the default user volume, 
then to the default system volume. When specifying a user file (which has 
user number ^ and does not reside on the system volume), a default volume ID 
must have been named (or changed with the USE command) at logon. If 
specifying a system file (user number = 0), the volume ID may be omitted; the 
system volume is the default value. 

In addition to a system volume for system files and user volumes for user 
files, a temporary file volume and a spooler file volume are used to contain 
temporary files and spooler files, respectively. An ampersand (&) as the 
first character in the filename field identifies a temporary file. A 
commercial at sign (@) in the first character position of the filename field 
defines a spooler file. 

When the spooler task is created, the system administrator may provide a 
spooler volume ID. If no volume ID is specified at that time, the system 
volume ID is the default value. 

The default temporary volume ID always uses the system volume ID. When the 
LUN assignment between the file and the temporary volume is closed, temporary 
files are deleted. 

If the user number field value is -1, it defaults to the user's logon user 
number. A value of -2 defaults to all user numbers only for a Fetch- 
Directory-Entry request (refer to paragraph 2.3.10). 



MICROSYSTEMS 



® 



MOTOROLA ^'^'^'^ MANAGEMENT FACILITIES 



1.3.2 Family Names 

Family names apply only to random access files and mean that a group of files 
have a common element in their file descriptors. Some FHS commands support 
handling of family names; for example, the Protect command can be used to 
protect all files on volume DSKl with the filename of PASCAL and any 
extension. 

FHS only recognizes a family on the Fetch-Directory-Entry request. An 
asterisk (*) in any position of the catalog, filename, or extension field 
means match any character (e.g., a*******.SA means any filename beginning with 
A and ending with extension SA) . A user number of -2 returns files for all 
user numbers. 



1.3.3 User Number Protection 

The user validation file identifies each authorized user and is accessible 
only to the system administrator. To use the system, a user must log on to 
the system; this could involve a password known only by the user and the 
system administrator. 

To coordinate a group of users, the file manager recognizes the concept of 
private and system files. System files are readable by all users but can only 
be written by either the system administrator or a system task. Private files 
are readable by all users (provided the matching read-protect code is supplied 
or the file-protect code is 0), but can only be written to by the owner or 
system administrator. The file system uses the user number of the authorized 
user to distinguish among private filenames; thus, users can freely use any 
private filename without interference with other user files. 

1.4 DISK STRUCTURE 

The physical layouts of data on hard disk and floppy disks are not the same. 
The two devices have different sector sizes, a different number of sectors per 
track, and a different number of tracks per disk. These differences are 
normally transparent to the user because the respective disk controller 
handles them. Sectors are accessed on either device via a Physical Sector 
Number (PSN). The corresponding disk controller decodes the PSN into the 
appropriate cylinder/sector position. (When referring to "sector" in this 
manual it is defined as a logical sector that is always 255 contiguous bytes 
of data.) 

A portion of each disk (both hard and floppy) is reserved for some special 
system tables. Although the tables may not be the same size, they are 
identical in format between the two disk devices. 

For additional details on disk data structures, refer to the description of 
the REPAIR utility in the M68000 Family VERSAdos System Facilities Reference 
Manual . 
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1.4.1 Volume Identification Block (VID) 



The Volume Identification Block (VID) is created during disk initialization. 
It contains a volume ID, the version and revision number of the resident 
operating system, the date the disk was generated, a user name identification 
area, and a user number. In addition, it contains pointers to the Sector 
Allocation Table (SAT) and directory. The VID is the only system table that 
must always reside in the same place on the disk, i.e., at PSN 0. Refer to 
the description of the INIT utility in the M68000 Family VERSAdos System 
Facilities Reference Manual for an explanation of the creation of the VID. 

1.4.2 Configuration Area (CFGA) 

Disk initialization creates the Configuration Area (CFGA) that contains 
information about the configuration in effect at the time the disk is 
initialized. This information is used to set the current configuration at the 
time the disk is mounted. Refer to the description of the REPAIR utility in 
the M68000 Family VERSAdos Systems Facilities Reference Manual and the disk 
configuration parameter block (refer to paragraph 3.5.5) in this manual for 
details on the contents of the CFGA. 



1.4.3 Sector Allocation Table (SAT) 

The SAT contains a bit map of the areas on the disk that are available for new 
space allocation. Each bit in the SAT represents a sector of disk storage. A 
bit set to 1 indicates that the sector is allocated. If a bit is set to 0, it 
indicates that the corresponding sector is available for allocation. The 
parts of the SAT that represent sectors beyond the physical end of the disk 
are marked as allocated so that they cannot be used. The start of the SAT and 
the number of sectors is in the VID. The number of sectors allowed for the 
device determines the length. 

1.4.4 Primary Directory Block 

A directory is maintained on each volume and contains the names of the files 
residing on that volume. 

The information maintained in the directory entry for each file is: 

Filename 

Extension 

File start and length or File Access Block (FAB) pointer 

File type 

Write and read access codes 

Record size 

The directory is expandable, with its size limited only by the amount of 
available disk space. 
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1.4.5 Secondary Directory Block 

A secondary directory block is also maintained and contains an entry for each 
unique user number/catalog on the volume. 

1.5 FILE STRUCTURE 

While the contents of a file can be thought of as a logically contiguous block 
of information, the actual disk area allocated to the file may or may not be 
physically contiguous. Space can be allocated to one or more groups of 
contiguous sectors on the disk. Each contiguous group of sectors is called a 
segment. This segmentation allows the dynamic allocation and de-allocation of 
space to occur without having to move any of the information contained in the 
file or in other files. 

Except for contiguous files, each file must have a table describing which 
segments are allocated to the file. This is referred to as the File Access 
Block (FAB). 

The I/O service routines access sectors within a file by Logical Sector Number 
(LSN). LSNs for data sectors are numbered sequentially beginning with 0. 
Thus, even though a file may be segmented (not physically contiguous on the 
disk), it is treated as a logically contiguous collection of sectors when 
accessed by an LSN. The system I/O functions decode the LSN into the PSN. 

1.5.1 File Formats 

Both hard and floppy disks support four file formats: 

Contiguous 

Sequential 

Indexed sequential with duplicate keys 

Indexed sequential without duplicate keys 

Contiguous files include binary load module files whose contents are to be 
loaded into, memory directly from the disk, in addition to any other type of 
user-defined .data that must have contiguous allocation. Contiguous files are 
allocated with the maximum amount of space they will ever need. The only 
information retained in binary load module files about where to load the 
content is kept in the first sector of the file called the Loader Information 
Block (LIB). The other data within the remaining file sectors contains no 
load or record information; it is just an image of a memory block to load. 

Sequential and indexed sequential files do not necessarily have contiguous 
allocation. Each has a FAB describing where all the segments of the file 
reside. Sequential file records may be accessed sequentially or randomly by 
logical record number. Indexed sequential file records can be accessed 
sequentially or randomly by key or logical record number. 
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1.6 RECORD STRUCTURE 



This section describes the three record types supported for disk files. 
Chapter 4 discusses the use of these records and the supported I/O functions. 

1.6.1 Contiguous Records 

Contiguous file records are also referred to as blocks. Each block is 256 
bytes in length. The user specifies the complete data content of the block. 
There are no embedded control characters generated by the File Management 
Service (FMS). (FMS is the facility that performs the FHS and lOS functions 
requested for files.) 

1.6.2 Variable Length Records 

The format of variable length records is: 



+ + 

I BC I Data I 

+ + 



where: 

BC = A word containing the number of bytes of data in the record. 

Data = The maximum number of data bytes is 65,280 ($FFOO). The data 
portion of the record can be any binary data. 

With the ASCII specification and a formatted write request, FMS compresses 
spaces. A data byte having the sign bit (bit 7) set to 1 indicates a space 
compression character. The remaining bits (0 to 6) contain a binary number 
representing the number of spaces to insert in place of the compressed 
character. FMS automatically expands these characters into spaces when such 
files are read using formatted ASCII I/O. When the file is created 
(allocated), if the specified fixed record length is 0, it has variable length 
records. If the record length is odd, a filler byte trails the end of the 
data portion. 

1.6.3 Fixed Length Records 

The user specifies the complete data content of the fixed length records. 
There are no embedded control characters generated by FMS. If, on allocation, 
a nonzero fixed record length was specified (i.e., when the file was created), 
sequential and indexed sequential files have fixed length records. 
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1.7 SYSTEM FILES 

At initialization, the file named ERRORMSG.SY is required. If not present, an 
error message is displayed after the boot process is complete. 

The user validation file contains a list of valid user numbers. Each user 
number has an associated password. The specified user number and password 
must be an entry in this file to enable the user to logon to the system. 

The user validation file is in indexed sequential format and allows user 
numbers from to 9,999. At least one entry must always exist in the file; an 
entry containing a user number of is always required. 

1.8 FILE ACCESS METHODS 

VERSAdos supports two methods of access to files: 

a. Random 

b. Sequential 

For sequential access, three modes exist: Next, Current, and Prior. Random 
and sequential access may be intermixed without closing and reassigning the 
file. 

A current record pointer is maintained for each assigned file that indicates 
the record to be read or written on the Next sequential access. At the time 
of assignment, the current record pointer is set so that a Next, request 
accesses the first record in the file. If the assignment was for position at 
end, the current record pointer is set so that records can be appended to the 
file by writing Next. 

On completion of either a random or sequential request, the current record 
pointer is set so that a request for Current accesses the same record; a 
request for Next accesses the next record in sequence (unless it is a read 
request and no new records exist); and a request for Prior accesses the prior 
record (unless the current record pointer is already at the beginning of the 
file). 

A Rewind I/O request sets the pointer so that a Next request accesses the 
first record in the file. These commands set the current record pointer 
similar to an I/O Position request. 
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1.8.1 Random Access 

For random access, the user supplies the record number to be accessed. The 
record is found, the data transfer is performed, and the current record 
pointer is set to point to the random record requested. If the user continues 
to use random access, the current record pointer is ignored because it is 
readjusted on every call. However, the user may read or write a sequence of 
records starting with a known record number. Here, a single random call may 
be followed by a number of sequential calls for Next. 



With a sequential file, the user is somewhat restricted in 
access Write and Update-Record calls. The Update-Record ca 
replace any record of the same length currently in the file 
may be used to append one record to the end of the file. If 
specified is more than one record past the end of the 
rejected with End-Of-File (EOF) status, which means a file mu 
a sequential manner. For example, if the file has only five 
may be added, but a record number 15 could not be added. If 
call requests a non-existent record, an EOF error is returned 



using the random 

11 may be used to 

The Write call 

the record number 

file, the call is 

St be expanded in 

records, a sixth 

an Update-Record 



With an indexed sequential file, the user may access the file randomly in two 
ways: 

a. By logical record number (identical to sequential file access). 

b. By key value. 

If the file access is by key value, an Update-Record, Read, or Delete-Record 
request accesses the record with the requested key. For a Write request, the 
record is inserted in the file, positioned according to keys so that the keys 
remain in ascending order. 

For a contiguous file, any record within the file allocation may be read or 
written in any order. 

Noncontiguous files (sequential and indexed sequential) support record or 
block random I/O. To copy these types of files using record I/O would be time 
consuming; therefore, random logical sector I/O is supported for speed (i.e., 
a read or write of one sector might mean several records). Chapter 4 
discusses this assignment mechanism. 

1.8.2 Sequential Access 

Sequential access is the simplest and most common access method. The user 
performs a series of sequential Read or Write calls, usually NEXT causing 
records of the file to be read or written in sequence. The current record 
pointer is automatically adjusted at each access. 
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1,9 FILE AND DEVICE PROTECTION 

Files and devices have fixed and active protection. 



D 



1.9.1 Fixed Protection 

Each file or device has two access protection codes associated with it: one 
for read access and one for write access. Each code is one byte long and has 
any value from $00 to $FF. 

If the values of the protect codes are between $01 to $FE, the file or device 
may not be assigned for read or write access unless the operator or requesting 
task supplies the matching codes. 

If a protect code value is $00, the file or device is unprotected for that 
access mode and any protect code is valid. 

If a protect code value is $FF, the file is unconditionally protected for that 
mode. It may not be assigned to any non-owner user task for that access mode, 
regardless of the code supplied. The owner may assign a file with either a 
read- or write-protect code of $FF and read a protected file. However, the 
owner cannot write into a write-protected file. The purpose of assigning it 
was probably to change the write-protect code to later allow write access of 
the file. An unconditionally protected file may be assigned to an Executive 
task, including the system administrator. 

Examples of fixed protection: 



MEANING 

Completely unprotected. 

Unconditionally protected. 

Unprotected for read; conditionally protected 
for write (user must supply write code = $0F). 

Unconditionally protected for write. 
Conditionally protected for read. 

Unprotected for write; unconditionally protected 
for read. 

Conditionally protected for both read and write. 



WRITE 

PROTECT 

CODE 


READ 

PROTECT 

CODE 


$00 


$00 


$FF 


$FF 


$0F 


$00 


$FF 


$0F 


$00 


$FF 


$32 


$70 
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The file protection codes are defined when the file is allocated. The 
terminal operator or any task having that file assigned for exclusive access 
may change the access protection codes (refer to paragraph 1.9.2). The 
protection codes are changed with an operator Rename command or a Protect FHS 
call. 

The device access protection codes are defined at initialization time; only 
the system administrator can change them. 

1.9.2 Active Protection 

When a task has assigned a file and it is being used, it can prevent other 
tasks from accessing that file. For this reason, the user may ask for 
exclusive access permission, for either read or write, at assignment time. 
This form of protection is called active because it is only in effect while 
the file remains assigned. 

The access permission is known by the abbreviations: 

PR Public read 

ER Exclusive read 

PW Publ ic write 

EW Exclusive write 

PRPW Public read-write 

PREW Public read, exclusive write 

ERPW Exclusive read, public write 

EREW Exclusive read-write 

A file cannot be assigned with an access permission that is incompatible with 
an existing assignment for that file. For example, a request to open a file 
for exclusive write only is compatible with an existing assignment of that 
file for PR or ER but is incompatible with any existing assignment for other 
access permissions. Table 1-1 shows compatibilities and incompatibilities 
among access permissions. 

1.9.3 Write Protection 

When a volume is write-protected, only read assignments (public read or 
exclusive read) are accepted. If the hardware write-protected feature of a 
disk or tape is enabled, the volume is write-protected. 
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TABLE 1-1. Compatible Access Permission 



n 



PR 



ER 



PW 



EW 



PRPW 
I PREW 
I I ERPW 
I I I EREW 



Public read 






X XX 


X 


Exclusive read 






X X 




Public write 






X* X* X* 


X* 


Exclusive write 






X* X* 




Public read-write 






X* X* 


X* 


Public read, exclusive 


write 


X* 




Exclusive read, pi 


iblic 


write 


X* 




Exclusive read-wri 


te 









* For sequential files only 



1.9.4 Protection Modification 

The terminal operator or any task having that file assigned for exclusive 
access can change a file's protection codes. If the task has the file 
assigned for exclusive read, it can change the read access protection code; if 
it is assigned for exclusive write, the write-protect code can be changed; and 
if the task has the file assigned for EREW, it can change either or both 
codes. 

If the proper conditions are met, a task can change its file access permission 
without closing the file. For example, a task with a file assigned for public 
read cannot change to exclusive read if the file is also assigned for public 
read to another task (or another logical unit of the same task). Access can 
always be changed from exclusive to public. The Change-Access-Permission 
option of the FHS call performs this change. 

If the user attempts to change access permission and is unable to get the new 
permission, the old access permission remains. 
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1.9.5 Multiple Logical Unit Considerations 

Exclusive access has been discussed in terms of multiple tasks sharing the 
same file. It was assumed that a single task does not attempt to assign the 
same file to multiple logical units. However, sometimes the task wants to 
assign the same file to multiple LUNs occurring as a result of default 
assignments or the terminal operator's assignments. Here, exclusivity applies 
between LUNs just as between tasks, which means a file cannot be assigned for 
exclusive read access on one LUN and shared read on another. If a file is 
assigned for exclusive read or write access on any given LUN, it may not be 
assigned for that access on any other LUN. 

1.10 TEMPORARY AND SPOOLER FILES 



1.10.1 Temporary Files 

Bulk storage of temporary data use temporary files. The temporary file 
operator command or a special form of the FHS allocates and assigns temporary 
files. Refer to paragraph 2.3.2.1. 

Temporary files have a special filename consisting of the special character & 
and an alphanumeric string of characters based on the time and date of 
allocation. 

Temporary files exist only as long as they are assigned, and are deleted when 
the assignment is closed. If a volume is not specified, temporary files are 
allocated on the default temporary volume. The set default volume command, 
DEF, can change the default temporary volume. 

1.10.2 Spooler Files 

Spooler filenames start with the special character @. When the file is 
allocated, FHS generates the remainder of the filename. Spooler files must be 
sequential. All requested record I/O is forced to be image. On record Write 
requests, the lOS parameter block options word is inserted at the beginning of 
the record. Rn read requests, the options word written with the record is 
returned as the first part of the record. 

If a volume is not specified, spooler files are allocated on the default 
spooler volume. The DEF command can change the default spooler volume. 
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CHAPTER 2 
FHS - FILE HANDLING SERVICES 

2.1 GENERAL 

A File Handling Services (FHS) call facilitates file and device manipulation. 
The facilities provided are: 

a. Allocation (creation) of direct-access files 

b. Assignment of files and devices to Logical Units (LUNs) 

c. Modification of access permission on existing assignments 

d. Renaming of files 

e. Modification of file access protection codes 

f. Closing (unassignment) of assigned files and devices 

g. Deletion of direct-access files 
h. Checkpointing of assigned files 

i. Examination of attributes of assigned files and devices 

j. Getting directory entries 

k. Getting device mnemonics 

1. Changing LUN assignment 

m. Retrieving system or user default volume 

n. Cancelling a spooler job 

0. Continuing a spooler output 

p. Changing forms ID 

q. Adding or changing a spooler job 

r. Changing the number of copies for a spooler job 

s. Outputting the spooler queue listing 
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2.2 FHS PARAMETER BLOCK 
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The 40-byte FHS parameter block is described in Figure 2-1. Although all 
fields of this parameter block are not required for each FHS function, the 
full parameter block of 40 bytes must be reserved for all calls. The meaning 
and use of each field is explained in the description of each function 
requiring that field. The parameter block address is passed to FHS in 
register AO. 



REQUEST CODE 


$00 1 


COMMAND 


$01 1 


OPTIONS 


$02 1 


STATUS 


$04 1 


LUN (Logical Unit Number) 


$05 1 


VOLUME ID 


$06 1 


USER NUMBER 


$0A 1 


CATALOG NAME 


$0C 1 


FILENAME 


$14 1 


EXTENSION 


$1C 1 


RESERVED (MUST BE 0) 


$1E 1 


WRITE-PROTECT CODE 


$20 1 


READ- PROTECT CODE 


$21 i 


RECORD LENGTH 


$22 1 


SIZE/POINTER 


$34 1 



FIGURE 2-1. FHS Parameter Block (TRAP #3) 
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The parameter block must be on a word boundary, reside in a single memory 
management unit segment and may be coded as: 



PARBLK: 



DC.B 


CODE 


DC.B 


CMD 


DC.W 


OPT 


DC.B 





DC.B 


LUN 


DC.B 


'VOLN' 


DC.W 





DC.B 


'CATALOG ' 


DC.B 


'FILENAME' 


DC.B 


'EX' 


DC.W 





DC.B 


WCODE 


DC.B 


RCODE 


DC.W 


RECL 


DC.L 


SIZE 



Command code 
Command (1 byte) 
Options (2 bytes) 
Status (I byte) 
LUN (1 byte) 
Volume ID (4 bytes) 
User number (2 bytes) 
Catalog name (8 bytes) 
Filename (8 bytes) 
Extension (2 bytes) 
Reserved (2 bytes) 
Write code (1 byte) 
Read code (1 byte) 
Record length (2 bytes) 
Size (4 bytes) 




Appendix A provides a table specifying the required parameter for each 
function and the FHS parameter block. 

The following paragraphs describe the FHS parameter block fields. 



2.2.1 Commands/Options 

The code field defines the bit assignments in the command field: 



$00 


Device/file commands 


$01 


Utility commands 


$02 


Spooler commands 


$03-$7F 


Not used 


$80 


Privileged use 


$81-$FF 


Not used 
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2.2.1.1 Code $00 Commands . If more than one command bit is set for code $00 
commands, the FHS functions are sequentially processed from left to right. 

BIT MEANING 

7 Allocate Requires file type field as option. 

6 Assign Requires access permission and transfer method 

fields as options. 

5 Change-Access- Requires access permission field as option. 
Permission 

4 Rename 

3 Protect 

2 Close 

1 Delete 

Checkpoint 

2.2.1.2 Code $00 Options . The option code is defined as: 

Bits 15-12 User-specified attributes. 

Bit 11 Specifies the option to return the physical address of the 
shared data buffer. When bits 11 and 5 are set, the 
returned shared segment logical address is the same as the 
segment physical address. Refer to paragraph 2.2.13 for 
additional information. 

Bits 10-8 File type: 

000 = Contiguous 

001 = Sequential 

010 = Indexed sequential (no duplicate keys) 

Oil = Indexed sequential (duplicate keys allowed) 

IXX = Reserved 

Bit 7 Reserved. 
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Bit 6 Position option: 

= Position current record pointer at beginning of file at 

assign 

1 = Position current record pointer at end of file at 

assign 

Bit 5 Shared segment option: 

1 = Allocate shared data buffer at assign 

Paragraph 2.2.13 describes additional parameters required 
if bit 5 is set. 

Bit 4 Reserved. 

Bit 3 File overwrite option: 

1 = Overwrite existing file 

Bits 2-0 Access permission: 

000 = Public read (PR) 

001 = Exclusive read (ER) 
010 = Public write (PW) 
Oil = Exclusive write (EW) 

100 = Public read-write (PRPW) 

(Uses: device, output with input; file, normal read/write) 

101 = Public read, exclusive write (PREW) 

110 = Exclusive read, public write (ERPW) 

111 = Exclusive read-write (EREW) 

(Uses: device, output with input; file, normal read/write) 

2.2.1.3 Code $01 Commands . 

BIT MEANING 

7 Retrieve-Attributes 

6 Fetch-Directory-Entry 

5 Fetch-Device-Mnemonics 

4 Change-LUN-Assignment 

3 Fetch-Default-Volume 

2 Reserved 

1 Reserved 

Reserved 
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The options code for the Fetch-Default-Volume (Command = $08) is defined as: 
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VALUE MEANING 

Return system default volume 

1 Return temporary default volume 

2 Return spooler default volume 

3 Return default volume for this session 



The parameter block format for the Fetch-Device-Mnemonics call (command = $20) 
is: 



CODE 1 COMMAND 




OPTIONS 


. 

STATUS 1 LUN 




POINTER 


POINTER (cont'd) 




LENGTH 


LENGTH (cont'd) 




RESERVED (25 BYTES) 


RESERVED 


(cont'd) 



where: 

pointer 
length 



contains the address of a receiving buffer. 

is the number of bytes in the buffer. Refer to paragraph 
2.3.10 for the buffer format. 



2.2.1.4 Code $01 Options . The options code is defined as: 

VALUE MEANING 

0-3 Not used 

4 Return random access devices 

5 Return interactive devices 

6 Return printer devices 
7-$F Not used 
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The parameter block format for a Change-LUN-Assignment call (command = $10) 
is: 



CODE 
STATUS 



COMMAND I OPTIONS 

LUA I LUB I RESERVED 
TASKNAME 
TASK SESSION 
RESERVED (24 BYTES) 



H 



LUA denotes the calling task logical unit number. LUB denotes the called task 
LUN. 

The option code is defined as: 

Bit Change LUN direction: 

= Send LUN 

1 = Receive LUN 

Bits 1-14 Reserved 

Bit 15 Whether existing assignment should remain: 
1 = Keep assignment 



2.2.1.5 Code $02 Commands . Code $02 commands are defined for the spooler 
task. These commands are invalid if the spooler task is not loaded. 



BIT 


MEANING 


7 


Cancel 


6 


Continue 


5 


Forms 


4 


Print 


3 


Copies 


2 


Queue 


1-0 


Reserved 



Cancel a spooler job 

Continue a spooler job 

Change forms ID for a spooled device 

Add a job to the spooler output queue or output a 
spooler job now 

Change number of copies for a spooler job 

Display the spooler queue 
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Any reference made to a non-spooler filename from code $02 commands must be 
the complete file descriptor of voln, user number, catalog, filename, and 
extension. Any reference made to a spooler filename is the filename and 
extension. A spooler job ID is a 4-byte field. The first 2 bytes are for the 
binary user number, and the second 2 bytes is the binary job number. 

For the Cancel call (command = $80), the format of the parameter block is: 



CODE 


1 


COMMAND 


RESERVED 


STATUS 


1 
1 


RESERVED 


VOLUME ID 


VOLUME 


ID 


(cont'd) 


USER NUMBER 




CATALOG 






CATALOG 


(cont'd) 


FILENAME 


FILENAME (cont'd) 


EXTENSION 




RESERVED 


RESERVED 






JOB 


ID 



For the Continue call (command = $40), the format of the parameter block is: 



CODE COMMAND 


RESERVED 


STATUS RESERVED 


DEVICE NAME 


DEVICE NAME (cont'd) 
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For the Forms ID call (command = $20), the format of the parameter block is: 



CODE I COMMAND 

I 
STATUS I RESERVED 

DEVICE NAME (cont'd) 



RESERVED 
DEVICE NAME 
RESERVED 



RESERVED 
RESERVED 
RESERVED 
RESERVED 
RESERVED 
RESERVED 
FORMS ID 




For the Print call (command = $10) and the Copies call (command = $08), the 
parameter block is: 



CODE I COMMAND 

I 

STATUS I RESERVED 

VOLUME ID (cont'd) 



EXTENSION 



BINARY OF COPIES 
VOLUME ID 
USER NUMBER 
CATALOG 
CATALOG (cont'd) 

FILENAME 
FILENAME (cont'd) 

I RESERVED 
RESERVED 
JOB ID 
DEVICE NAME 
FORMS ID 



Used by Print command 
to specify a non- 
spooler filename not 
in spooler queue. 
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For the Queue call (command = $04), the parameter block is: 

+- 




CODE 1 COMMAND 


OPTIONS 


__ 

STATUS 1 RESERVED 


DEVICE NAME 


DEVICE NAME (cont'd) 


USER NUMBER 


USERS CONSOLE NAME 



2.2.1.6 Code $80 Commands . All code $80 commands are privileged and require 
a system task to execute them. 

BIT MEANING 

7-1 Reserved 

Assign-Default-Volume 



2.2.2 Error Status 

The status byte interpretation depends on the command specified in the call 
and is defined under the description. A status means the desired options 
were performed without error. Table 2-1 gives a summary of all possible error 
codes. The error status is also returned in register DO. Certain device 
dependent disk I/O errors return the PSN in error in the size field. The Z 
bit of the condition code is set or cleared to indicate no error or an error 
return, respectively. The format of the error status in DO is: 

BITS VALUE 

31-27 3 
26-8 

7-0 Error code (same 
($180000XX) 



as status field) 



The first error detected causes the call to return. If multiple functions 
were specified (e.g.. Allocate and Assign), some functions may have been 
performed properly (always in left-to-right sequence). 
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TABLE 2-1. FHS Return Status Codes 



ERROR CODES 


MEANING 


$00 


No error 


$01 


Operating system task does not exist 


$02 


Inval id command 


$03 


Invalid logical unit 


$04 


Volume error 


$05 


Duplicate filename 


$06 


File descriptor error 


$07 


Protect code error 


$08 


Record length error 


$09 


Shared segment error 


$0A 


Insufficient directory space 


$08 


Access permission error 


$0C 


Insufficient system space 


$0D 


Invalid assignment 


$0E 


Invalid device type 


$0F 


Invalid transfer method 


$10 


Invalid taskname 


$11 


Invalid buffer address 


$12 


Invalid file type 


(^ t o 


Internal error 


$14 


Invalid parameter block address 


$15 


Data block error 


$16 


Size error 


$17 


Non-existent filename 


$18 


End of directory 


$19 


Key error 


$1A 


FAB length error 


$1B 


Default volume not defined 


$1C 


File not ready to output 


$1D 


User number not owner or user #0 


$80-FF 


1/0 errors 



B 



2.2.3 Logical Unit Number (LUN) 

This byte defines the LUN used for all the FHS functions except Allocate, 
Delete, and Fetch-Default-Volume. 

2.2.4 Volume ID 

This 4-byte ASCII field identifies the volume for direct-access devices or the 
device mnemonic for non-direct-access devices. The Allocate, Assign, Delete, 
and Retrieve-Attributes functions require this field. 
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The volume ID field, the user number, catalog, filename, and extension fields 
identify a file descriptor. The system returns either the volume ID or device 
name in the volume ID field on a Retrieve-Attributes call. Volume ID is a 
required field with default assignments (blank fill). Refer to paragraph 
1.3.1 for a description of default handling. If the default volume ID is 
requested in an Allocate, Assign, or Delete request, the actual value is 
returned in the parameter block. A Fetch-Default-Volume request returns the 
appropriate default volume in the volume ID field. 

When assigning a device (such as CNIO or PR) to a LUN, the device name appears 
in the volume ID field, left-justified and blank filled on the right. The 
catalog, filename, and extension fields are ASCII blanks and the user number 
is 0. 



2.2.5 User Number 

This 2-byte field is provided for manipulating data created under the user 
environment. It is a method of ownership. The system returns the user number 
on a Retrieve-Attributes call; it is for a non-direct-access device. Default 
values are described in paragraph 1.3.1. If the default user number is 
requested on an Allocate, Assign, or Delete request, the actual value is 
returned in the parameter block. 

2.2.6 Catalog Name 

Catalog Name is an 8-byte ASCII field and is part of the file identification 
on a direct-access device; it is not required for a non-direct-access device. 
The catalog name is left-justified and filled with blanks to the right. The 
user must specify the catalog name for Allocate, Assign, Rename, and Delete 
calls. The system returns the catalog name on a Retrieve-Attributes call; it 
is blank for a non-direct-access device. 



2.2.7 Filename 

Filename is an 8-byte ASCII field that is part of the file identification on a 
direct-access device; it is not required for a non-direct-access device. 
Filename is left-justified and filled with blanks to the right. The user must 
specify the filename for Allocate, Assign, Rename, and Delete calls. The 
system returns the filename on a Retrieve-Attributes call; it is blank for a 
non-direct-access device. 



2.2.8 Extension 

This 2-byte ASCII field typically identifies the file type (e.g., RO, LO, SA, 
etc.) on a direct-access device. It is treated as the filename field and it 
is required under the same conditions. Refer to paragraph 1.3. 
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2.2.9 Two- Byte Reserved Field 

This field must be initialized to and is reserved for future enhancement. 

2.2.10 Write/Read-Protect Code 

Access protection codes for direct-access files and devices are specified 
using this word. The Allocate, Assign, Protect, and Delete functions require 
these codes. The Retrieve-Attributes call uses this field to return the 
device or file attributes. 



B 



2.2.11 Record Length 

This word field, on an Allocate call, must contain the logical record length 

for a non-contiguous file. If 0, the file has variable length records; 

otherwise, it must be an even number from 2 to 55,280 ($FFOO). 

On a Retrieve-Attributes or Assign call, the file's logical record length or 

device's physical record length is returned in this field. Record length is 
not used for other functions. 



2.2.12 Size/Pointer 

The size field is defined for the Allocate call, depending on the type of file 
being allocated. For a contiguous file, the size field must be a longword 
containing the file size in sectors. 

For a noncontiguous file, the size field is redefined to four 1-byte fields: 



RESERVED 



KEY SIZE 



FAB SIZE 



DATA BLOCK SIZE 



The key size is only used for indexed sequential files. It specifies the 
length of the key field and must be an even number between 4 and 100 
inclusive. For indexed sequential files with duplicate keys, the range is 
through 100. 

The FAB size contains the size in sectors of each file access block. The FAB 
size specified at allocate must be a number between and 20 inclusive. If 
the FAB size is specified as 0, File Management Services (FMS) allocates one- 
sector FABs. 

The data block size contains the size in sectors of each data block in the 
file. The data block size specified at allocate must be a number between 4 
and 255 (inclusive) or 0. If the data block size is specified as 0, the FMS 
allocates four sector data block sizes. 
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On a retrieve attributes or assign call for a file, the size field is returned 
in the format described above. For direct access devices, size returns the 
number of sectors on the device. Size is not used for a non-direct-access 
device. 

On a Fetch-Directory-Entry request, the size field is treated as a pointer to 
a 60-byte receiving buffer whose format is described in paragraph 2.3.10. 



2.2.13 Shared Segment Information 

If the shared segment option (bit 5) is requested on an Assign call, the 
parameter block is expanded at the end by 12 bytes. The format of this 
information is: 



SHARED SEGMENT USER STARTING 
LOGICAL/PHYSICAL ADDRESS 



SHARED SEGMENT USER ENDING 
LOGICAL/PHYSICAL ADDRESS 



SHARED SEGMENT NAME 



+ 



+ 



Unless bit 11 is set, the starting logical address must be passed by the 
caller. When bit 11 is set, FHS returns the starting logical address of the 
segment to the user, which is the same as the physical address. Regardless of 
the setting of bit 11, FHS returns the segment name and the logical ending 
address. With the shared segment option set, FHS allocates a segment to be 
used for the data block and allows the caller to access the segment by 
attaching the user to the segment. When FHS attaches the segment to the user, 
the user's starting logical address is used if bit 11 is 0. If bit 11 is set, 
FHS attaches the user to the segment, forcing the logical address of the 
segment to be the same as the physical address. When the file is closed, FHS 
detaches the caller. The segment size is determined by the data block size 
specified at allocation. The user must request a shared segment if performing 
block writes to a noncontiguous file, or if record and block I/O is mixed. 
The shared segment option is ignored if the assignment is to a contiguous file 
or volume. 
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2.3 FHS CALL DESCRIPTIONS 

2.3.1 Allocate 

The Allocate function reserves space on a direct-access device and in the 
directory for the specified file type. For a contiguous file, the entire file 
extent is reserved. For noncontiguous files, only a directory entry is 
reserved. The access protect codes are entered in the directory. The 
required parameters are: 




Volume ID: 



User number: 



Catalog/filename/ 
extension: 



Specifies the volume on which the file is to be allocated. 
It must be the name of an online direct-access 
volume; otherwise, "volume error" is returned. 

Assigns each filename a number from to 65,533 with 
established ownership by system or user ID. 



Gives the newly allocated file its name. No other file can 
be on the specified volume under the specified user number 
with this name; otherwise, "duplicate filename error" is 
returned. 



Write/read 
protect code: 



Record length: 



Sets up the initial protection 
Defaults to unprotected. 



codes for the file. 



Size: 



Use this field when allocating a noncontiguo 
the logical record length for the file; any 
to 65,280 bytes. This number must be less th 
the data block size for the file and once 
cannot be changed. Specification of a 
indicates the file contains variable length 
to paragraph 1.6.2). A user other than 
allocate files on a volume owned by someone e 
can allocate files on the system volume (if i 
number is 0). 

Contiguous file: 



us file. Sets 
even number up 
an or equal to 
established it 

record length 
records (refer 

user cannot 
Ise. Any user 
ts volume user 



This size is the entire file in sectors. It may be any 
size up to the maximum amount of contiguous space available 
on that volume at that time. If the requested size is 0, 
"size error" is returned. If more space is requested than 
exists on the volume, "insufficient space" is returned. 
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Noncontiguous file: 

This is the data block size for the file in sectors. It 
can be any size up to the maximum set at initialization 
time for the system, but never greater than 255. If this 
parameter is too large, it may be difficult to open the 
file. It also includes the size of the FAB. The key size 
is included for indexed sequential files. 

File type: Contiguous, sequential, indexed sequential with duplicate 
keys, or indexed sequential without duplicate keys. 

A file may be allocated either from the terminal or from a user program via 
FHS. If either the default volume or user number is requested, the actual 
assigned values for both are returned to the caller. 

Applicable error codes are: 

$02 Invalid command; attempt to allocate spooler file by non-system 
task. 

$04 Volume error; the specified volume was not mounted. 

$05 Duplicate filename. 

$06 File descriptor error; syntax error. 

$07 Protect error; user number conflict. 

$08 Record length error; Record length is not an even number or 
record length too large for data block size. 

$0A Insufficient directory space. 

$0B Permission error; entire disk currently assigned exclusive 
read/write. 

$0E Device type error; the specified volume is not a direct-access 
device. 

$12 Invalid file type. 

$14 Invalid parameter block address; outside user space. 

$15 Data block length error; data block length less than 4. 

$19 Key length error; key size less than 4 (0 is acceptable if 
duplicate keys) or greater than 100 or not even or greater than 
record length. 

$1A FAB length error; FAB length greater than 20. 

$80-FF I/O error. 
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2.3.2 Assign 

2.3.2.1 Assign Function . The Assign FHS call from a user program or the 
Assign command from a terminal assigns a file or device to a logical unit. At 
the time of assignment, the system allocates (out of system space) a File 
Control Block (FCB) and buffers for noncontiguous files. The buffer space 
required, if any, depends on the file's data block size and FAB size. If the 
file's block size for the remaining system space is too great, the file may 
not be opened. Here, it returns an "insufficient system space" error status. 
When a space error occurs, the user program can close another open file 
assignment, freeing some system space and allowing the first file assignment 
to be retried. 

Files should not be kept open longer than necessary and unless there are other 
overriding considerations, the file's physical block lengths should be kept as 
short as possible. 

The Assign function establishes a logical connection between a file (or 
device) and the task through a specified logical unit under a given access 
permission. The call proceeds as follows. 

First, examine the access permission to determine which access protect codes 
to check. The proper protect code is then checked against the codes in the 
file directory. For a read assignment, neither the owner of a file nor user 
need match the read-protect code, all other users must. Only the owner or 
user can issue a write assignment. The write-protect code must match. An 
assignment with a write-protect code of $FF is allowed to support file rename 
and protection changes. If there is no conflicting assignment, the file is 
then assigned according to the requested access permission. For all volume 
and file assignments except sequential files, any write access permission is 
changed to EREW . For sequential files, multiple write accesses are allowed 
for appending to the end of the file. If a write assignment is specified for 
a noncontiguous file and the overwrite option was selected, all file space is 
deallocated when the first write request is made. If a sequential file is 
assigned with multiple write assignments and more than one overwrite request, 
the first overwrite is processed and the others are ignored. If the option to 
position at end is selected, the current record pointer is set to the logical 
end-of-file so that records can be appended by doing Write NEXT requests. 

If the shared segment option is requested, FHS allocates a data buffer and 
attaches the calling task to it. If the assignment is for a contiguous file 
or volume, the shared segment option is ignored. The required parameters are: 

Access permission 

LUN 

Protect codes (Wcode and/or Rcode, depending on access permission) 

Volume ID 

User number 

Catalog name 

Filename 

Extension 
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User number, catalog name, filename, and extension fields are not used for 
non-direct-access devices, and should be initialized with spaces (except user 
number field that should be set to 0). 

For an assignment to a device marked as a spooler device, and spooling is 
initiated, a forms ID may be specified. The forms ID field is redefined as 
the first 4 bytes of the catalog field. If this field is spaces, standard 
forms ID is used by the spooler. Otherwise, the 4-byte content is used as the 
forms ID for the spooler. 

The information returned to the caller for an assignment to a file or volume 
is: 

Record length 

Size 

File type 

Device type (Bits 10-8 of option word) 

User attributes (Bits 15-12 of option word) 

In addition, the volume ID and user number are returned if the default was 
requested for either. For a temporary or spooler file assignment, the system 
generated filename is returned to the caller. These fields are returned in 
the FHS parameter block in the positions required by the Allocate command. 

Applicable error codes are: 

$03 LUN error; invalid LUN. 

$04 Volume error; no such volume. 

$05 File descriptor error; syntax error. 

$07 Protect error; mismatch on access protection codes or nonowner 
attempted write assignment. 

$09 Shared segment error; user passed starting logical address 

conflicts with existing logical addresses or user's segment 

space full or device assignment with shared segment option 
selected. 

$0B Permission error; requested permission may not be granted for 
file, or entire disk is currently assigned exclusive read/write. 

$0C Insufficient system space error; no room for FCB or shared 
segment. 

$0D Assignment error; LUN already assigned or offline. 

$17 Nonexistent filename. 

$80-FF I/O error; interpreted as lOS error codes defined in Chapter 3. 
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2.3.2.2 Temporary File Creation . The system recognizes temporary files. 
These files are temporary because they are deleted when closed. 

A temporary file can be created by using FHS: 

If an Allocate or Assign call specifies a filename with a first character 
of ampersand (&), the FMS generates a temporary filename. If volume 
identification is not specified, the file is placed on the temporary 
volume. If a temporary volume ID has not been specified via operator 
command, the file is placed on the default system volume. Using & for a 
first character and appending an internal counter creates a unique 
filename and extension. This filename is placed in the filename field of 
the FHS parameter block. 

An attempt to allocate only or to assign only automatically allocates a 
temporary file and assigns it to the specified LUN. Required parameters are: 

User number 

File type 

LUN 

Record length 

Size 

& as first character of the filename 



2.3.3 Change-Access-Permission 

This function allows the user to change the current access permission of an 
assigned file or device. The LUN and access permission portions of the 
options field are required. In addition, if the access permission is being 
changed from non-read to read, the read-protect code must be provided. The 
write-protect code must be provided if going from non-write to write. 

The requested new access permission cannot, however, conflict with existing 
assignments. For example, if the file was assigned for EW, an access 
permission requiring write access is not allowed. Refer to Table 1-1 for 
information about compatible access permissions. 

If an error is encountered while processing this request, the file remains 
assigned with its original access permission. 

Applicable error codes are: 

$03 LUN error; invalid LUN 

$07 Protect error; user number/protect code conflict 

$0B Permission error; new permission cannot be granted 

$0D Assignment error; LUN not assigned 
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2.3.4 Rename 

The Rename function changes an assigned filename or device name. For a file 
rename, the file must be assigned for EREW. The required parameters are: 

LUN 

User number 

Catalog name 

Filename 

Extension 

If the Rename call is successful, the specified user number, catalog name, 
filename, and extension fields replace the previous user number, catalog name, 
filename, and extension fields in the directory. For a device rename, if the 
device supports both read and write, the assignment must be for EREW. If the 
device supports only read, the assignment must be for ER. If the device 
supports only write, the assignment must be EW. For a device rename, the 
required parameters are LUN and the new device ID. Only system tasks can 
rename non-direct-access devices. 

Applicable error codes are: 

$03 LUN error; invalid LUN 

$05 Duplicate filename 

$06 File descriptor error 

$07 Protect error; file protected by protect codes 

$0B Permission error; file not assigned for EREW 

$0D Assignment error; LUN not assigned 

$80-FF I/O error as returned by lOS 

2.3.5 Protect 

This function changes an assigned file's access protection codes. The 
required parameters are protect codes and LUN. The given LUN must be assigned 
to a direct-access file. The file must be assigned for EREW. If a device is 
specified that supports both read and write, the device must be assigned for 
EREW. If the device only supports read, the assignment must be ER. If the 
device only supports write, the assignment must be for EW (unless the caller 
is a privileged task that may modify the protection codes of non-direct-access 
devices). If the call is rejected, the previous protect codes remain 
unchanged. 

Applicable error codes are: 

$03 LUN error; invalid LUN 

$0B Permission error; not assigned for EREW 

$0D Assignment error; LUN not assigned 
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2.3.6 Close 

This function discontinues an assigned logical connection between a task and a 
file or device. LUN is the only required parameter. The file's directory 
entry is updated and the specified LUN is unassigned. A busy status is 
returned for logical units with outstanding I/O to haltable devices. The 
system waits for any incomplete write data transfers to terminate and writes 
out any partly filled buffers to the volume. After a Close, temporary files 
are automatically deleted. The allocated data segment for the file is 
deallocated. If it was a shared segment (specified at assignment), FHS 
detaches the calling task from it. 

Applicable error codes are: 

$03 LUN error 

$0D Assignment error; LUN not assigned 
$80-FF I/O error as returned by lOS 

2.3.7 Delete 

This function deletes the file's directory entry by zeroing out the first 
character of the filename field, and releases the space on the disk previously 
occupied by the file. For a Delete function, the volume ID, user number, 
catalog name, filename, and extension and protect code parameters must specify 
a direct-access file that is not currently assigned. Only the owner or a 
privileged task can delete a file, provided the write-protect code is matched 
and the file is not delete-protected {$FF). If these conditions are met, the 
file is deleted from the directory of its volume. The sectors previously 
occupied by the file on the disk are marked as available in the sector 
allocation map. 

If either the default volume or user number was requested, the actual assigned 
values for both are returned to the caller. 

Applicable error codes are: 

$04 Volume error; no such volume 

$06 File descriptor error 

$07 Protect error; invalid protection codes 

$0B Permission error; file not closed, or entire disk currently 
assigned exclusive read/write 

$0E Device type error; non-direct-access device 

$17 Non-existent filename 

$80- FF I/O error as returned by lOS 
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2.3.8 Checkpoint 

The Checkpoint call performs the buffer-clearing and directory-updating 

functions of a Close call without performing other functions of a Close 

operation. This is a protective operation to guard against system failure for 

either critical files or files running for lengthy time periods without being 
closed. 

The Checkpoint function empties the buffered FMS buffers by writing to the 

file (or by copying the buffers to the user's input buffer) and updates the 

directory entry for an indexed file. LUN is the only required parameter. 

Requesting a Checkpoint for a contiguous file or for a non-direct-access 

device has the same effect as an lOS Wait-Only call (refer to paragraph 
3.3.3). 

The applicable error codes are: 

$03 LUN error 

$00 Assignment error; LUN not assigned 
$80-FF I/O error as returned by lOS 

NOTE 

The user may use checkpointing after sensitive data is added to a 
buffered file. Logical blocking of data in memory in system buffers 
leaves the file vulnerable. Checkpointing can preserve the data's 
integrity on the direct-access device. In case of system failure, 
all data on files up to the latest Close or Checkpoint operation is 
recoverable; data appended after the most recent Checkpoint is lost. 
Checkpoint differs from a Close/Assign sequence because reposition- 
ing is not performed. Filename, access permission, and protect 
codes need not be specified. 

2.3.9 Retrieve-Attributes 

For proper operation, certain programs may require knowledge of the device or 
file physical attributes associated with a given LUN; for example, to know if 
random access is possible or if the device is rewindable. The Retrieve- 
Attributes function gives the user access to this information. 

Applicable error codes are: 

$03 LUN error; invalid LUN 

$0D Assignment error; LUN not assigned 
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Some fields within the FHS parameter block are redefined for this call. The 
only required parameter is the logical unit. The system returns information 
in fields: 

Options 

Volume ID or Device Name 

User number 

Filename 

Extension 

Size 

Protect codes 

Record length 

The write/read code word is redefined to receive an attributes word {refer to 
Table 2-2). Any bit set means the device or file supports the corresponding 
attribute. 



TABLE 2-2. FHS Device Attributes Word 



B 



BIT 


MEANING 


15-11 


Reserved 


10 


Supports spooling 


9 


Printer device 


8 


Interactive device 


7 


Supports filemark 


6 


Supports position record 


5 


Supports halt I/O 


4 


Supports image 


3 


Supports random 


2 


Supports binary 


1 


Supports write 





Supports read 


Bits 1 and reflect 


the current access permission. For 


example, if a file 


is assigned with read only access 


permission, it has b 


it 1 reset in the device attributes. 



If the record length is fixed, the system sets the record length field to the 
physical record length associated with the device (e.g., 80 or 132 for a line 
printer, 256 for floppy/hard disk); these 2 bytes are set to for a variable 
record length device (e.g., magnetic tape). For the contiguous file, the 
record length is set to 255. For a noncontiguous file, it is the logical 
record length chosen for that file at its allocation time. 

The volume ID, user number, catalog, filename and/or extension for a named 
file, or the device mnemonic for a device are returned in the file descriptor 
portion of the parameter block. 



39 

MICROSYSTEMS 



(g) MOTOROLA 



FILE HANDLING SERVICES 



I 



The current size of a contiguous file is returned in the size field. The size 
field is formatted as described for the Allocate function (refer to paragraph 
2.3.1) for noncontiguous files. The number of physical sectors is returned 
for a disk or volume assignment. For a non-direct-access device, size 
contains the page length (i.e., the number of lines per page). For a device 
with no page length, size is set to 0. These sizes are returned as unsigned 
binary numbers. 

The options code most significant byte is set to indicate the file or device 
type. Table 2-3 lists the codes for all supported devices. In addition, for 
files, the user attributes are returned in the options code in the position 
required by the Allocate function. 



TABLE 2-3. Device Codes 
CODE FILE OR DEVICE TYPE 



Contiguous file 

1 Sequential file 

2 Indexed sequential file (no duplicate keys) 

3 Indexed sequential file (duplicate keys allowed) 

20 Serial port on VERSAmodule 01 

21 Parallel port on VERSAmodule 01 

30 Interactive terminal on IPC interface (Motorola EXORterm 155) 

31 Non-EXORterm 155 terminal on IPC 

35 Interactive terminal on local driver (Motorola EXORterm 155) 

36 Non-EXORterm 155 terminal on local driver 
60 Magnetic tape 

90 Low speed line printer on IPC 

91 High speed line printer on IPC 

95 Low speed line printer on local driver 

100 Asynchronous communications line 

255 Null device 



To obtain information about a device, do a Configuration-Status request (TRAP 
#2) which returns a channel type code field and a device type code field in 
the configuration status block. The device type code field displays the type 
of device; terminal, printer, tape, floppy disk, or hard disk. The attributes 
word and parameters provide more detailed information about the device 
configuration. Refer to paragraph 3.3.9 for more details. 
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2.3.10 Fetch-Directory-Entry 

For a Fetch-Directory-Entry call, the given LUN must be an assignment (usually 
public read) to a volume ID, i.e., the Assign call must have specified only 
the volume ID; the rest of the file descriptor must have been initialized to 
blanks. 

The Fetch-Directory-Entry call causes the size/pointer field to be interpreted 
as a pointer to a 60-byte buffer. 

The first/next directory entry is returned in the buffer for each Fetch- 
Directory- Entry command. The search criteria for family names (refer to 
paragraph 1.3.2) can be given in the filename fields of the parameter block. 

A user number field value of -1 defaults to the logon user number. A user 
number of -2 defaults to all user numbers only for the Fetch-Directory-Entry 
call. 

An asterisk (*) in any position of the catalog name, filename, or extension 
field means match any character. 
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The format of the 60-byte block returned to the user is: 



B 



-- + 




2 

10 



USER NUMBER 
CATALOG 

FILENAME 



18 


EXTENSION 


20 


RESERVED 


22 
24 


FILE START 


25 
28 


FILE END 


30 
32 


LOGICAL SECTOR END OF FILE 


34 
35 


LOGICAL RECORD END OF FILE 


38 WRITE CODE 


1 39 READ CODE 


40 ATTRIBUTES 


1 41 LAST DATA BLOCK SIZE 


42 


LOGICAL RECORD LENGTH 


44 RESERVED 


|45 KEY SIZE 


46 FAB SIZE 


1 47 DATA BLOCK SIZE 


48 


DATE FILE ALLOCATED 


50 


DATE FILE LAST ASSIGNED 


52 
58 


RESERVED 
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The format of the attributes field is: 



Bits 7-4 User attributes 

Bits 2-0 File type 

3 = Indexed sequential (with duplicate keys) 

2 = Indexed sequential (without duplicate keys) 

I = Sequential 

= Contiguous 

Applicable error codes are: 

$06 Access permission error; LUN not assigned to volume. 

$11 Invalid data buffer; address in size field not in user segment 
space or not in read/write segment. 

$18 End of directory; no more directory entries exist. 

$80-FF I/O error as returned by lOS. 

2.3.11 Fetch-Device-Mnemonics 

A logical unit assignment is not required for the Fetch-Device-Mnemonics call 
and can be executed at any time. The FHS block pointer field points to a 
buffer whose length is contained in the size field. Device entries are 
returned in the buffer. The size field is modified on return to indicate the 
number of entries returned in the buffer, as well as the total number of 
entries that exist for the request. The format of the size field on return 
is: 




NO. OF ENTRIES RETURNED 



TOTAL NO. OF ENTRIES 



The format of each entry returned is: 
+ 



DEVICE NAME 

4 VOLUME ID 

8 RESERVED I 9 STATUS 
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The volume ID is returned if the device is random access and if a volume is 
currently mounted. If the volume ID is 0, there is no volume ID associated 
with the device. 

The status byte is defined: 

BIT MEANING 

7-3 Reserved 

2 Device status changed 

1 Write-protected 

Offline 



This call is used to find out the existence of devices known to the system. 
After the device name is found, it can be assigned and a Retrieve-Attributes 
call placed to obtain its functionality. The call would be helpful in being 
able to send messages to all interactive devices. For a random access device, 
the user should do the assignment by specifying the volume ID unless that 
field is 0. In that case, the device name should be used. 

Applicable error codes are: 

$0F Buffer overflow; user buffer too small to contain all requested 
device mnemonics. 



$11 Invalid data buffer; 
address is odd. 



user's return buffer not in his space or 



2.3.12 Change-LUN-Assignment 

The Change-LUN-Assignment call is an intertask function and requires 
coordination between two tasks. (The Change-LUN-Assignment parameter block is 
described in paragraph 2.2.1) Two functions are provided: 

Send request 

LUA contains the LUN for the existing assignment. LUB contains the LUN 
for the new assignment and must not be assigned. The taskname/session 
contains the ID of the task that will receive the new assignment. If the 
taskname/session is all zeros, the ID of the task that called FHS is used 
(i.e., a task is changing its own LUN assignment). The sending task must 
be a system task if the sessions are not the same. As a result of this 
operation, the calling task LUN is closed and the called task LUN is now 
assigned. Only a system task can send LUN 0. 
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Receive request 

LUA contains the LUN to receive the assignment and must be not assigned. 
LUB contains the LUN of the existing assignment. Only a system task can 
receive a LUN 0. The taskname/session contains the ID of the task that 
owned LUB. As a result of this operation, LUB is closed. The called task 
must be DORMANT, PAUSED, or SUSPENDED. Note that a task can close another 
task's LUN by issuing an FHS Receive-LUN and an FHS Close. 

With the keep option set, the send request is converted to a send and keep and 
the receive to a receive and keep. In neither case is the original LUN 
assignment closed. 

Applicable error codes are: 

$02 Invalid function. 

$03 LUN error. 

$07 Protect code error; on a change and keep request, the assignment 
was for a temporary file. 

$09 Shared segment error; attempt to change LUN for file with shared 
segment. 

$0B Access permission error; on a keep request, the original LUN 
assignment was for exclusive access. 

$0C Insufficient system space; on a keep request for a file, 
insufficient buffer space exists. 

$00 Assignment error. 

$10 Invalid taskname. 

2.3.13 Fetch-Default-Volume 

The Fetch-Default-Volume call does not require a logical unit assignment, and 
can be executed at any time. On return, the volume ID field is modified to 
contain the requested default volume. 

Applicable error codes are: 

$02 Invalid function. 

$03 Default volume not defined. 
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2.3.14 Cancel 

The Cancel function is defined for the spooler task. This function deletes 
the associated queue entry for the spooler task, stops output if currently 
being output, and deletes the file if it is a spooler file. A user other than 
user cannot cancel queue entries owned by someone else. User number must be 
specified as either a numerical user number or two ASCII stars '**'. If user 
specifies two stars, all files in the queue will be deleted, regardless of 
user number. If any other user specifies two stars, an error will be 
generated. If no other fields are specified, all entries for that user are 
cancelled. To cancel one job, specify either filename or job ID. All unused 
fields are to be set to binary 0. 

Applicable error codes are: 

$02 Spooler task not loaded. 

$13 File being output now but unable to send an event to the task 
doing the output. 

$17 Non-existent filename; non-existent job ID. 

$1D User number not owner or user #0. 

$80-FF I/O error as returned by lOS. 

2.3.15 Continue 

The Continue function is defined for the spooler task. It is used to start 
output of a spooler file to a spooler device after a Forms ID command or after 
an I/O error was encountered and corrected while outputting. Device name must 
be specified. 

Applicable error codes are: 

$02 Spooler task not loaded. 

$0E Invalid device name specified. 

$13 Not able to send an event to the task doing the output, on pending 
I/O error. 

$80- FF I/O error as returned by lOS. 
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2.3.16 Forms 

The Forms function is defined for the spooler task, and is used to change the 
forms ID of a spooler device. After the current job being output to the 
spooler device is completed, nothing is output until a Continue command is 
issued. At that time, only jobs with matching forms ID are output. Both 
device name and forms ID parameters are required. Forms ID is a 4-byte ASCII 
field. 

Applicable error codes are: 

$02 Spooler task not loaded. 
$0E Invalid device name or forms ID specified. 
$80-FF I/O error as returned by lOS. 

2.3.17 Print 

The Print function is defined for the spooler task. It has two purposes: 

a. To add a non-spooler filename to the spooler queue for output. 

b. To start output of a filename already in the spooler queue, overriding 
the file's existing output priority. 

The user number parameter is required. A user other than user cannot print 
queue entries owned by someone else. To start output of a filename already in 
the spooler queue, specify filename or job ID parameters. To add a non- 
spooler filename to the spooler queue for output, the filename descriptor and 
device name parameters are required. The forms ID parameter contains the 
forms ID wanted, or binary for the default forms ID of STND. The number-of- 
copies field contains the binary number of copies to output. If this 
parameter is binary 0, and a non-spooler filename is being added to the 
spooler queue, the default number of copies is 1. If the filename is already 
in the spooler queue and the number-of-copies parameter is binary 0, the 
existing number of copies are output; otherwise, the parameter value is used. 

Applicable error codes are: 

$02 Spooler task not loaded. 

$17 Non-existent filename. 

$IC File not ready to output. 

$1D User number not owner or user #0. 

$80-FF I/O error as returned by lOS. 
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2.3.18 Copies 

The Copies function is defined for the spooler task. This function is used to 
change the number of copies for a spooler queue entry to output. The user 
number and number-of-copies parameters are required. Job ID or filename 
parameters must also be specified. The number-of-copies parameter is the 
binary number of copies to output. If this parameter is binary 0, one copy is 
output. A user other than user cannot change the number of copies for a 
queue entry owned by someone else. 

Applicable error codes are: 

$02 Spooler task not loaded. 

$17 Non-existent filename. 

$10 User number not owner or user #0. 

$80-FF I/O error as returned by lOS. 

2.3.19 Queue 

The Queue function is defined for the spooler task. It is used to view the 
contents of the spooler queue and the status of any spooler devices that have 
had assignments made to them. Any user may view the spooler queue. The 
applicable parameters are option, device name, user number, and user's console 
name. User's console name is required. To view the entire queue, set option, 
device name, and user number parameters to binary O's. To view queue entries 
of the current session, set the option parameter to binary 1 and the device 
name and user number parameters to binary O's. To view the queue entries for 
a specified device, set the device name parameter to a spooler device name and 
the option and user number parameters to binary O's. To view queue entries 
for a specified user, set the user number parameter to the binary user number 
wanted and the option and device name parameters to binary O's. To view the 
spooler devices with their current forms ID setting and current status, set 
the device name parameter to FORM and the option and user number parameters to 
binary zeros. 

Applicable error codes are: 



$02 Spooler task not loaded. 
$80-FF I/O error as returned by lOS. 
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CHAPTER 3 
lOS - INPUT/OUTPUT SERVICES 

3.1 GENERAL 

A task calls Input/Output Services (lOS) to do all general -purpose I/O. The 
information describing the required activity is passed to the lOS module in a 
standard lOCB parameter block. When a task requires a change to the existing 
configuration of peripheral attributes and parameters before execution of the 
I/O, the necessary information is first passed to the lOS module in a separate 
configure lOCB parameter block (refer to paragraphs 3.4.1 and 3.4.2). 

lOS calls are: 

a. Read from a file or device. 

b. Write to a file or device. 

c. Write to then read from a device. 

d. Update a record. 

e. Delete a record. 

f. Format a disk/sector. 

g. Position to a particular record of a file. 

h. Rewind or position to the beginning of a file. 

i. Terminate outstanding I/O. 

j. Place a task into I/O WAIT. 

k. Request an attention event for a break condition. 

1. Send a break to LUN specified. 

m. Suspend a calling task until the specified device is free. 

n. Proceed with concurrent task execution. 

0. Release a task from break services. 

p. Set device-specific configuration. 

q. Change device-specific parameters assigned at SYSGEN. 

r. Return device configuration. 
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3.2 THE STANDARD lOCB 

The parameter block shown in Figure 3-1 is used for requesting I/O with a 
peripheral when the existing configuration of parameters and attributes for 
that peripheral does not have to be changed for the I/O. 



a 



REQUEST CODE 


$00 1 


FUNCTION SPECIFICATION 


$01 1 


OPTIONS 


$02 1 


STATUS 


$04 1 


LUN 


$05 1 


RESERVED 


$06 1 


RANDOM RECORD NUMBER 


$08 1 


BUFFER START ADDRESS 


$0C 1 


BUFFER END ADDRESS 


$10 1 


LENGTH OF DATA TRANSFER 


$14 1 


COMPLETION SERVICE ADDRESS 


$18 1 



FIGURE 3-1. The Standard lOCB 



Because the error status is returned to the parameter block, a standard lOCB 
parameter block must be on a word boundary and in the writable segment of the 
program address space. The following example shows how to code an lOS call 
using this parameter. 

lOSBLK: 



DC.B 


CODE 


Request code 


DC.B 


FCT 


Function specification 


DC.W 


OPT 


Options 


DC.B 





Status 


DC.B 


LUN 


Logical unit 


DC.W 





Reserved 


DC.L 


RECNUM 


Random record number 


DC.L 


START 


Start address 


DC.L 


END 


End address 


DC.L 





Length of data transfer 


DC.L 


RETURN 


Completion address 
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All fields are not required for every request. For some requests, a field may 
be redefined. Refer to paragraph 3.2 for individual field details. The 
parameter block address is passed to lOS in the AO register. 

For each lOS function, Appendix B specifies the required parameter fields for 
each request code, the entire parameter block must reside within one Memory 
Management Unit (MMU) segment. 

3.2.1 Request Code Field 

The Request Code Field specifies data transfer requests, command requests, and 
privileged requests. Table 3-1 defines this field. 

TABLE 3-1. Request Code Field Values 
VALUE MEANING 



B 



$00 Data transfer requests 

$01-$02 Command requests 

$04-$3F Not used 

$40 Nonvalidated command 

$41-$7F Not used 

$80 Privileged requests 

$81-$FF Not used 

If the request code byte does not indicate a valid request, the system 
immediately returns an invalid function code ($02) to the user. By using the 
Retrieve-Attributes FHS call, the user can determine which commands the 
logical units support. 

3.2.1.1 Data Transfer Functions (Request Code $00) . Table 3-2 defines the 
function specification field for each data transfer request. The bit value 
must be 1 to start the corresponding function. 

TABLE 3-2. IDS Data Transfer Functions (Code $00) 



BIT 


MEANING 


7 


Reserved 


6 


Transmit-Break 


5 


Format 


4 


Delete-Record 


3 


Update-Record 


2 


Output-with-Input 


1 


Write 





Read 
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If an invalid bit setting is specified, the request is rejected as an illegal 
function. Refer to status field description (refer to paragraph 3.2.2). For 
example, a function specification field value of $01 specifies a request for 
read. 



3.2.1.2 Command Functions Request (Request Codes $01 and $02) . Table 3-3 
defines the function specification field for command requests, code $01. 
Table 3-4 defines the function specification field for command requests, code 
$02. 



TABLE 3-3. lOS Command Functions (Code $01) 
BIT MEANING 



7 Configure-Device 

6 Configuration-Status 

5 Local -Break-Claimer (Break Service) 

4 Halt-I/0 

3 Wait-Only 

2 Test-I/O-Complete 

1 Rewind 

Position 



Claim/Negate Driver Events : 

These level 2 command requests allow a task to receive events directly from an 
I/O device driver and to cancel this facility. The exact structure of the 
event is driver-dependent. Not all device drivers support every command. 

TABLE 3-4. IDS Command Functions (Code $02) 
BIT MEANING 



Reserved 



2 Negate driver events 

1 Claim driver events 

Negate-Local -Break-Claimer (Break Service) 



Chapter 4 lists the specific commands supported by individual I/O devices 
under the description for each device. Paragraph 1.8 explains the 
implementation of command functions for direct-access files. 
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Level 40 Request Codes : 

The purpose of the level 40 function is to allow an I/O driver to handle all 
function validity tests. The lOS level 40 function handler has no knowledge 
of the command, options, or parameter block structure. It does handle basic 
lOS checks -- LUN validation, parameter block length, and reserved field zero. 
Assignment must be to a driver only, not a file. 

3.2.1.3 Privileged Requests . For a request code $80, a supervisor task can 
communicate with the IDS module for privileged access. This call's function 
specification and options fields will be redefined. Request code $80 is not 
executable by a user task. Table 3-5 defines the function specification field 
for Privileged Requests. 

TABLE 3-5. lOS Command Functions (Code $80) 

BIT MEANING 



B 



Reserved 



Configure-Defaults (System 
Function - Unclaimed Breaks) 
Reserved 



3.2.1.4 Options . The Options Field specifies the type of transfer to be 
performed. Table 3-5 defines the option code field for each data transfer 
request. 



TABLE 3-6. lOS Data Transfer Options 
MEANING 



BIT 



15 



14-13 



TASK ID 


1 



No task ID supplied. 
Task ID supplied. 



LOGICAL ACCESS/POSITION 

00 Access/position to next record. 

01 Access/position to current record. 

10 Access/position to prior record. 

11 Access/position to random record specified in Random Record 
Number (RRN) field. 
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TABLE 3-6. lOS Data Transfer Options (cont'd) 
BIT MEANING 



12 FORMAT OPTION 

A Used with Format command to disk. 

Format entire disk. 

1 Format track (requires Physical Sector Number (PSN)). 

B Used with Read or Output-with-Input commands to terminal. 

Do not flush type ahead buffer. 

1 Flush type ahead buffer before doing read. 

C Used with Write command to terminal. 

Do not clear the "discard output" condition. 

1 Clear the "discard output" condition before doing read. 

D Used with Configure-Device command 

Do not dismount the device. 

1 Dismount the device. 

11 RETRY/FORMAT OPTIONS 

A Used with Read/Write commands to disk. 

Retry the command. 

1 No retries. 

B Used with Format command to disk. 

Do not format the track as bad. 

1 Format the track as bad (requires PSN of the first bad 
sector in the track). (No other option bit may be set.) 

C Used with Configure-Device command to disk. 

Use error correction. 

1 Do not use error correction. 

10 INPUT FORMATTED/IMAGE (see NOTE) 

(Valid only for the "input" action of Output-with-Input commands) 

Format input according to device and state of bit 0. 

1 Do not format (image mode). 
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TABLE 3-6. lOS Data Transfer Options (cont'd) 
BIT MEANING 



COMPLETION/SERVICE ADDRESS 

Return task normally. 

1 Return task to the address specified in the completion 
field. 

RETURN KEY WITH RECORD 

Do not return key to the user on a record Read request. 
Ignore unless indexed sequential file type. 

1 Return key to the user on a record Read request. 
LOGICAL RECORD/RANDOM KEY ACCESS 

Perform logical record I/O by logical record number. 

1 Perform random record I/O by key value. Valid only for 
indexed sequential files. Ignore if bit 6 is set. 

RECORD/BLOCK ACCESS 

Perform record access. 

1 Perform block access. 

SUPPRESS ECHO 

Do not suppress echo. 

1 Suppress echo. 

BREAK NOTIFICATION 

(Valid only for I/O termination) 

Task receives shared notification. 

1 Task receives exclusive notification. 

OUTPUT FORMATTED/IMAGE 

(Valid for Read and Write requests and the output action of the 
Output-with-Input request) 

Format request according to the device/file and the setting 
of bit 0. Ignore if contiguous file or volume assignment. 

1 Do not format request (image mode). In image mode, the 
user must include all carriage returns and line feed 
operations explicitly. 
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TABLE 3-6. lOS Data Transfer Options (cont'd) 
BIT MEANING 



B 



2 CONNECTION WAIT 

Place task in Connection Wait state until the requested 
device/file is free. At that time, process request. 

1 Reject request if the requested device/file is not free. 
1 WAIT/PROCEED 

(Indicates the action taken after the I/O has been initiated) 

Wait. Put task in I/O Wait until the data transfer is 
complete. 

1 Proceed. Return control to task after initiation of I/O. 
CONFIGURE/FORMAT OPTIONS 

A Used with Configure-Device command 

Mount device. 

1 Configure device, but do not mount. 

B ASCII/BINARY options 

(Indicates the type of formatting requested) 

ASCII formatting requested. 

1 Binary formatting requested. 

If bit 3 is set or file data type is not ASCII, this bit is ignored. 

NOTE: The term "formatted" (as opposed to "image") refers to a data transfer 
between program and peripheral. Formatted or image mode data transfer 
can be specified for Write, Read, and Output-with-Input. 

Details of formatted and image m.odes depend on the particular device. 
In general, formatted mode is more convenient and people-oriented. For 
example, formatted input from a terminal includes several useful line- 
editing features. Image mode provides a more transparent data 
transfer, i.e., fewer interpretations and restrictions are placed on 
the data. This makes the data transfer less convenient for the human 
user but far more flexible if the user is talking to a device rather 
than to a person. In this mode, if some format is desired on input or 
output, the caller must supply all EOL markers or other codes the 
peripheral requires, and accommodate any format requirements. For 
example, a value of $16003 in the function and options field specifies 
a request for: read, binary formatting, proceed, random access. 
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3.2.2 Status Field 

The system returns the execution status of the requested function in the 
status field byte. If an error occurred, this status byte is set to indicate 
the general type. If an error did not occur, it is set to 0. The status 
code is also returned in register DO. Certain device dependent disk errors 
return a sector number in the Random Record Number (RRN) field. The Z bit of 
the condition code register is set if no error occurred; it is cleared if 
there was an error. 

The status code format returned in DO is shown in Table 3-7. 



TABLE 3-7. Register DO Status Format 
BIT VALUE 



D 



31-27 2 
26-8 
7-0 Status byte as returned 
in lOS parameter block 
(SIOOOOOOXX) 



Chapter 4 explains the specific interpretations of the status codes as applied 
to devices. Table 3-8 gives the general definition of the status byte values. 

TABLE 3-8. Interpretation of lOS Status Byte Value 
CODE MEANING 

$00 No error 

*** Syntax Errors *** 

$81 Operating system task does not exist 

$82 Invalid function 

$83 Invalid logical unit 

$84 Invalid data buffer address 

$85 Invalid random record 

$86 Invalid parameter block address 

$87 Protect code error 

$88 Configuration parameter block error 

*** Device- Independent Errors *** 

$C1 Buffer overflow 
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TABLE 3-8. Interpretation of lOS Status Byte Value (cont'd) 
CODE MEANING 



$C2 End of file 

$C3 End of volume 

$C4 Invalid FAB 

$C5 Invalid transfer for device 

$C6 Break condition 

$C7 Internal error 

$C8 FAB/data block conflict 

$C9 Record does not exist 

$CA Record already exists 

$CB Record overflow/too many records in data block 

$CC Key error, FAB/key conflict 

$CD Insufficient disk space 

$CE Unrecoverable file error 

$CF File space allocation/deallocation conflict 

*** Device-Dependent Errors *** 

$01 Unrecoverable device error 

$D2 Data compare error (sector number returned) 

$D3 Sector protect error (sector number returned) 

$D4 Device not mounted 

$D5 Beginning of tape detected (magnetic tape only) 

$D6 Input formatter error (General Purpose Interface Bus 

(GPIB) only) 

$D7 Tape already mounted (magnetic tape only) 

$D8 TMS9914A handshake error (GPIB only) 

$D9 Invalid command/mode combination (GPIB only) 

$DA Invalid command for busable device (GPIB only) 

$DB Run-time error (GPIB only) 

$DC Invalid sector address (GPIB only) 

$DD Invalid request for pending interrupt (GPIB only) 

$DE Invalid command for bus (GPIB only) 

$DF Data transfer aborted (GPIB only) 

$EI Device not ready 

$E2 Device/file busy 

$E3 Data CRC error (sector number returned) 

$E4 Write-protected device 

$E5 Deleted data mark detected (sector number returned) 

$E6 Timeout 

$E7 Invalid sector address 

$E8 Checksum error 

$E9 Disk restore error 

SEA Data overrun 

$EB Device status changed 

SEC Track/section ID not found (sector number returned) 

$ED Address mark CRC error (sector number returned) 

SEE Seek error 

$EF Bad sector (sector number returned) 
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TABLE 3-8. Interpretation of lOS Status Byte Value (cont'd) 
CODE MEANING 



*** Channel Errors *** 

$F1 Channel busy 

$F2 Channel DMA error 

$F3 Unrecoverable channel error 

$F4 Controller error 

$F5 Device configuration 

$F6 DMA bus error 

$F7 DMA mapping error 

$F8 DMA controller error 

$F9 Indeterminate channel error 




Generally, for a data request, if "invalid function", "device unavailable", or 
"invalid LUN status" is indicated alone, then data was not transferred. 
"Device unavailable" may indicate that the device is physically inoperative. 
If the device becomes unavailable after a transfer is started, the error is 
set to indicate that some data may have been transferred. 

3.2.3 Logical Unit Number (LUN) 

To provide device-independent I/O, all I/O requests are directed to a LUN. 
LUN is a number from to 255 that describes an entry in the task's LUN table. 
The maximum LUN for a system is determined at system generation. Before 
executing the lOS call, the operator command or FHS call must assign the 
particular device or file to the specified LUN. The call is rejected if an 
invalid or unassigned LUN is specified. If no operation is desired, the 
specified LUN should be assigned to the null device. An I/O operation to the 
null device is effectively a no-op, and is useful during program development. 

3.2.4 Two-Byte Reserved Field 

This 2-byte field is initialized to zero and is reserved for future 
enhancements. 
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3.2.5 Random Record Number (RRN) 

The RRN field specifies the logical record number (starting at 0) to be 
accessed on data transfer requests if the random record access option is set. 
The interpretation of this field is device-dependent and function-dependent. 

If the RRN field is minus one on a random logical record position request to a 
file, the current record pointer is positioned to the last record in the file. 
The current record pointer is returned in the RRN field only for file position 
requests. 

If the function byte indicates Output-with-Input, this field is redefined to 
the start buffer address for the input function (refer to paragraph 3.3.8 
"Output-with-Input"). 

3.2.6 Buffer Address 

For data transfer requests, the buffer-start and buffer-end fields specify the 
buffer. The buffer-start address is the first byte in the buffer and the 
buffer-end address is the last byte in the buffer. 

A buffer must start on a word boundary and must be fully contained in a user 
segment of the task address space. A buffer used in Read requests must be in 
a writable segment because the Read operation changes the memory locations. 
For random key access, the buffer contains the requested key. 

An lOS invalid address error occurs if: 

Buffer-start and buffer-end addresses are not in the user logical segment. 

Buffer-end address is less than buffer-start address. 

Buffer for a Read request is in a write-protected logical segment. 

3.2.7 Length of Data Transfer 

The length-of-data-transfer field returns the actual number of bytes 
transferred during a request, either Read or Write. This field is most useful 
when dealing with variable length records. The field contents are undefined 
if an error status is indicated, except for "buffer overflow" where the 
transfer length does reflect the number of characters transferred for a Read 
request. On a Position request, this field contains the offset to the start 
of the record in the data block. 

For an Output-with-Input request, this field serves a dual purpose: the 
initial value is the user-supplied input buffer length; on I/O completion, 
that value is overlaid with the length of the input data actually received (as 
described above) . 

When reading data from a Multi-Channel Communications Module (MCCM) serial 
port, if the number of bytes transferred is odd, a space is added to the end 
of a data transfer. 
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3.2.8 Completion/Address 

The completion-address field specifies a return address for I/O completion if 
the completion address option was selected. When an I/O request is initiated 
(with Proceed), setting bit 9 returns control to the task at the completion 
address. 

If the request is Proceed-I/0 and the calling task is set up to receive an 
event, the Asynchronous Service Queue (ASQ) automatically returns control to 
the task at the address specified (refer to Chapter 2 in the M58000 Family 
Real-Time Multitasking Software User's Manual). 

If the request is Proceed-I/0 and the calling task is not set up for task 
queue entry (no ASQ has been set up), the completion address is ignored. 

3,3 lOS CALL DESCRIPTIONS 

3.3.1 Connection-Wait- I/O 

Use a Connection-Wait-I/0 request when a task is waiting for the requested 
operation. The system coordinates I/O requests so that only one I/O request 
may access any device or file at a time. If Connection-Wait is requested and 
the specified device/file is in use at the time of the data transfer request, 
the lOS system suspends the calling task until the device is free and 
initiates the I/O request. If Connection-Wait is not specified and the device 
is in use, the lOS request is rejected and the error status is set to device 
busy. The calling task may retry the request at a later time. If the 
specified device is not in use, setting the Connection-Wait option does not 
affect the request. 

3.3.2 Proceed/Wait- I/O 

When an I/O request has been initiated (that is, the specified device is 
free), any Proceed-I/0 call returns control to the task so that the task may 
concurrently execute with the data transfer. Except for invalid function and 
invalid LUN, which are rejected before transfer initiation, the status is not 
set until I/O completion. Check for invalid function and invalid LUN status 
before proceeding with the concurrent task execution. 

Check the status of the I/O request by performing one of the following: 

a. Monitor (poll) the status field in the parameter block. 

b. Accept an event in the I/O task's ASQ on completion. 

c. Issue a Wait-Only request to the same LUN to wait for completion. 

An Wait-I/O call requests the lOS to suspend the calling task until completion 
of the I/O operation. 
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The format for an I/O completion event sent to the calling task is: 

+ + + 

|0 EVENT I 1 EVENT | 
I LENGTH (5) | CODE (2) | 
+ + + + + 

1 2 ADDRESS OF lOCB | 

I I 

+ + + + -+ 



3.3.3 Wait-Only 

A Wait-Only request function places the task into I/O Wait until the 
completion of a previous Proceed-I/0 request to the specified LUN. If a task 
does not have any outstanding I/O to the specified LUN, control is immediately 
returned. This call uses the function, LUN, and status fields of the lOS 
parameter block. Invalid LUN is the only error status this call returns. The 
status of the I/O being tested is returned in the parameter block associated 
with the original Proceed-I/0 call, not in the Wait-Only call's parameter 
block. 



3.3.4 Halt-I/O 

A Halt-I/O request attempts to cancel an Proceed-I/0 request previously 
issued. This is useful on an interactive terminal device. If the Halt-I/O 
request is not used, any outstanding I/O request must be satisfied before any 
other I/O can be started on a device. 

The printer and CRT devices support the Halt-I/O request. 

When issuing a Halt-I/O request, the lOS schedules the I/O operation for 
termination. The termination is asynchronous to the Halt-I/O request. When 
the I/O terminates, the task receives an event in its ASQ, if enabled. The 
completion event is identical to the I/O completion event described in 
paragraph 3.2.8. The address of the lOCB contained in the returned event is 
the address of the original data transfer parameter block and not the address 
of the Halt-I/O parameter block. 

There are two unique lOS parameter blocks involved in the Halt-I/O processing: 

a. The data transfer parameter block. 

b. The Halt-I/O command function parameter block. 

The user specifies the data transfer block when the I/O is initiated and the 
Halt-I/O parameter block when the halt is requested. 
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Note that the condition codes returned are unpredictable when a Halt-I/0 is 
requested. Instead, the user should monitor the status of the Halt-I/O 
command function parameter block. The pseudo-code that follows represents a 
routine that issues a Halt-I/O request and does not return until the I/O is 
halted or it is recognized that there is no I/O to halt. The condition codes 
resulting from the routine show whether the I/O is halted or not. 

Pre-set the status byte in the Halt-I/O parameter block with $FF. 
Issue the TRAP #2 call to halt the I/O. 



WHILE 

ENDW 
IF 



Status byte of Halt-I/O parameter block equal $FF. 
WAIT (use RELINQUISH directive) 



B 



status byte of Halt-I/O parameter block is then the I/O was halted. 

{In addition to the above there will be an $E6 in the status byte of 
the data transfer parameter block and a I/O termination event in the 
requestor's ASQ, if enabled). 

Return to caller. 



ELSE 



There was no I/O to halt. 

(There will be an $82 in the status byte of the Halt-I/O parameter 

block. 

An I/O completion event in the requestor's ASQ, if enabled. 

The status byte of the data transfer parameter block will reflect 

the status of the I/O completion.) 
Return 



ENDIF 
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3.3.5 Local -Break-Cl aimer 

This request applies only to interactive devices. When a break condition is 
present on the device specified, an attention event is sent to the requesting 
task (Local -Break-Claimer) . 

The format for a break attention event is: 



B 



+ + + 

|0 EVENT I 1 EVENT i 
I LENGTH (8) | CODE (6) | 
+ + + + + 

1 2 DEVICE MNEMONIC | 

I 4-character ASCII identifier; e.g., CNOl I 

+ + + + + 

1 6 DEVICE STATUS | 

I = device not assigned | 
I 1 = device assigned | 
+--- + + 



If bit 1 in the device status word is set, the specified device is assigned. 

The only option applicable is the option for service address and and it uses 
the standard lOS parameter block. Required entries are: 

Function 
Options 
LUN 
Status 



3.3.6 Negate-Local -Break-Cl aimer 

The Negate-Local -Break-Claimer request applies only to interactive devices. A 
task that previously requested break service (Local -Break-Claimer) may obtain 
release from break service responsibility via this request. The standard lOS 
parameter block is used and the required entries are: 

Function 

LUN 

Status 



3.3.7 Test-I/O-Complete 

A Test-I/O-Complete call returns with a condition code of "Z bit = 1" if there 
is no outstanding Proceed-I/0 to the specified LUN by the task. If an 
outstanding Proceed-I/0 exists, the call returns an error condition code of 
"Z bit = 0". 
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3.3.8 Output-With-Input 

An Output-with-Input operation on an interactive device that supports this 
call, allows a task to write to a device and issue a read for response at the 
same time. When a program issues an Output-with-Input request, the system 
writes the data in the user's data buffer for the length specified by the 
start and end addresses and before returning, issues a read for the length 
specified in the length field. The RRN field is redefined to indicate the 
start-buffer address of the input function. 

If the file is not opened for exclusive read/write access, an invalid function 
is returned. 



3.3.9 Update-Record 

The Update-Record request is valid only for an assignment to a noncontiguous 
file. An Update-Record request must be used to change an existing record in a 
file. If the record to be updated does not exist, a "record does not exist" 
error is returned. If a record Write is requested for an existing record, a 
"record exists" error is returned; the Update-Record command should have been 
used. For a sequential file, the new record must be the same size as the 
existing record, otherwise an "invalid data buffer address" error is returned. 

For an indexed sequential file, the new record must have the same key as the 
old record, otherwise "key error" is returned. "Invalid data buffer address" 
error occurs if the buffer is not large enough to accommodate the key. 

3.3.10 Delete-Record 

A Delete-Record request is valid only for an assignment to an indexed 
sequential file. If the requested record does not exist, a "record does not 
exist" error is returned. If the file is not opened for exclusive read/write 
access, an "invalid function" is returned. 

3.3.11 Format 

This request causes a disk or track to be formatted. The Format track option 
requires a PSN to calculate the appropriate track number. 

The options available are: 

Proceed 
Track 

Alternate track 
Completion address 
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The Format track option uses the RRN field of a standard lOS parameter block 
for the PSN and the buffer-start address for the alternative track PSN. The 
required entries are: 

Function 
Options 
LUN 
Status 

The logical unit assignment must be exclusive read/write for a random access 
device or volume. 



3.3.12 Transmit-Break 

This request, which applies only to interactive devices, sends a break 
condition to the LUN specified. The Transmit-Break request uses the standard 
lOS parameter block and the required entries are: 

Function 

Options 

LUN 

The only applicable options are those for service address and I/O with 
proceed. 

Any attempt to create this condition on a device whose assignment is read-only 
results in an invalid function ($82) error return. The device drivers that do 
not allow this function also return the same error. 



3.4 CONFIGURATION 



3.4.1 General Information 

Associated with each terminal, printer, and disk drive are two configurations 
of parameters and attributes: the default configuration and those parameters 
and attributes currently in effect. At SYSGEN time the user defines the 
default configuration that establishes the current configuration for each 
device when the system is booted. 

The lOS module provides three requests for obtaining and changing the current 
configuration values and for changing the default configuration values. 

a. Configure-Device 

b. Configure-Defaults 

c. Configuration/Status 
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In the lOS module context, the terms parameter and attribute refer to the 
discrete parcels of information that are conveyed to the device driver so that 
the driver can produce the desired peripheral activity. Parameters represent 
conditions or quantities having several values and are passed to the driver in 
parameter block fields of one or more bytes. For example, the length of the 
write timeout period requires a quantity in a parameter field. 

Attributes, on the other hand, represent conditions or actions that can have 
only two values. Consequently, attributes are associated with individual bits 
within a single field -- the attributes word. An example of an attribute is 
to use or not to use parity checking. 

Because an existing parameter or attribute of a peripheral may or may not need 
to be changed, a mechanism is provided to inform the device driver whether to 
take action or not according to the parameter field value or attribute bit 
state passed in the parameter block. The activating mechanism for changing 
parameters is the word contained in the parameters mask field in which 
individual bits correspond to fields further on in the parameter block. If an 
individual bit value is 1, the driver reads and acts according to the value 
contained in the corresponding parameter field. If the value of an individual 
bit is 0, the driver writes the current or default value of the parameter in 
the corresponding field of the user's parameter block. Figure 3-2 portrays 
the change parameter mechanism. 

NOTE 

Not all serial device drivers support all configuration 
attributes and parameters. Performing a Configuration- 
Status command returns the set of attributes and 
parameters supported for that device and drivers. 

TERMINAL CONFIGURATION BLOCK 



H 



$04 
Parameters Mask Field --> $06 Bit 9 --> |1| causes read of field value. 



$08 



Read Terminators Field --> $1F 



$2E Terminal driver updates parameter in 
accordance with field value. 



FIGURE 3-2. Change Parameter Mechanism Example 
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Similarly, the activating mechanism for changing attributes is the attributes 
mask field. Individual bits within this word length field correspond to 
individual bits within the attributes word field. If an attributes mask field 
bit is 1, the driver takes action based on the state of the corresponding bit 
in the attributes word. If the mask bit is 0, the corresponding bit in the 
attributes word is given the current or default value of the attribute. 
Figure 3-3 shows the change attributes mechanism. 

TERMINAL CONFIGURATION BLOCK 



Attributes Mask Field --> $04 Bit 4 --> 111 causes read of bit value. 



Attributes Word Field --> $08 Bit 4 



Terminal driver updates attribute in 
accordance with bit value. 



$2E 



FIGURE 3-3. Change Attribute Mechanism Example 

3.4.2 The General lOCB For Configuration Requests 

The parameter block shown in Figure 3-4 is used for reviewing or changing the 
default or current configuration of the peripheral's parameters and attributes 
before requesting I/O with that peripheral . The Configuration/Status Block 
(CSB) address field in this parameter block points to the configuration 
parameter block for a Configure-Device request and for a Configure-Defaults 
request. For a Configuration-Status request, the CSB address field points to 
the address where the current configuration values will be returned. 
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CODE 

FUNCTION 

OPTIONS 

STATUS 

LUN 

RESERVED 

CSB ADDRESS 

RESERVED 



$00 
$01 
$02 
$04 
$05 
$06 
$08 
$0C 



B 



RESERVED 



$43 



FIGURE 3-4. The General Configuration lOCB 



A configure lOCB parameter block must be on a word boundary and in the 
writable segment of the program address space because the error status is 
returned to the parameter block. The following example shows how to code an 
lOS call using the Configure-Device parameter block. 



lOSBLK: 



DC.B 


CODE 


Request code 


DC.B 


FCT 


Function specification 


DC.W 


OPT 


Options 


DC.B 





Status 


DC.B 


LUN 


Logical unit 


DC.W 





Reserved 


DC.L 


CSB 


CSB address 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 



All fields are not required for every request; the Configure-Device lOCB 
parameter block address must be passed to lOS in register AO. 
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3.4.3 The Configure-Device and Configure-Defaults Requests 

Any task that has an assignment for the device to be configured can execute 
the Configure-Device request. The new configuration remains in effect until 
it is changed by another Configure-Device request. When all assignments for a 
device whose configuration has been changed have been closed, the 
configuration reverts to a default configuration previously defined, either at 
SYSGEN time or by a previous Configure-Defaults request. Assignments to the 
same device can exist for multiple tasks at the same time. Therefore, one 
task could issue a Configure-Device request and affect the I/O of other tasks 
that would be unaware that a change to the configuration had occurred. An 
attempt to configure a spooler device while spooling is active results in an 
error. 

At SYSGEN time, the user defines the default parameters for all devices in the 
system. The default configuration is the device configuration in effect when 
an assignment is made to a device for which no other assignments exist. The 
user may alter the default configuration for a device at a later time by 
issuing a Configure-Defaults request from a system task. An attempt to alter 
a default configuration from a task that is not a system task results in an 
error ($82). It should also be noted that the write and read timeout values 
for a device can be altered only via the Configure-Defaults request. An 
attempt to alter these timeout values using a Configure-Device request results 
in a configuration error. 

If an error occurs in a configuration request, the status returned in the 
user's lOCB reflects a general code ($88) for a configuration error; however, 
the user may obtain the detailed error by examining the error code in the 
status/error field of the configuration parameter block. Configuration errors 
returned include errors common to all drivers (codes $01-$3F) and errors 
specific to a particular driver (codes $40-$7F). Codes $80-$FF are reserved. 
The device type code, channel type code, and driver code fields contain no 
significant information if an error exists. When a configuration error 
occurs, the current configuration or default configuration in effect before 
the error is unchanged. If the configuration request is successful, the 
status/error, channel type, device type, and driver code fields contain the 
information associated with each field. 



3.4.4 The Configuration-Status Request 

The Configuration-Status request may be executed by any task that has an 
assignment for the device for which the current configuration information is 
desired. In addition to the returned current configuration values, the 
status/error, channel type, device type, and driver code fields contain the 
appropriate information. 

The attributes and parameters mask fields returned in the configuration/status 
parameter block contain the mask of the attributes/parameters that are 
supported by the driver of the requested device. If a bit is set, the 
corresponding attribute/parameter is supported. A reset condition indicates 
that the attribute/parameter is not recognized by the driver. The user, after 
obtaining the current configuration information, can alter the desired 



^° MICROSYSTEMS 



(^ MOTOROLA 



lOS - INPUT/OUTPUT SERVICES 



attributes by issuing a Configure-Device request with appropriate attributes 
and parameters mask fields. Any attributes/parameters mask bits not supported 
by the driver must be set to when a Configure-Device or Configure-Defaults 
request is made; otherwise, a configuration error occurs. 

The general lOCB parameter block for a Configuration-Status request is the 
same as for a Configure-Device request, except that the CSB address field 
contains an address to which the current configuration values are moved. 
Specific meanings of bits within the status/error and device type code fields 
of the configuration parameter blocks returned for terminals, printers, disks, 
and magnetic tape are shown in paragraphs 3.5.1, 3.5.2, 3.5.3, 3.5.4, 3.5.5, 
3.5.5, and 3.5.9. Returned values for all fields in the configuration 
parameter blocks for terminals, printers and disks are described in paragraph 
3.2.1.4. Regardless of the equipment, bit 7 when set means "device not 
ready". 
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FIELD 

TERMINAL 

Status/error 
On/off Line 



PRINTER 

Status/error 
On/off Line 



DISK 



Status/error 






Protection 


5 



1 


On/off Line 


7 




1 


MAGNETIC TAPE 






Status/error 






Tape density 


2,1,0 






Density select 4 



Write 
Protection 

On/off Line 



BIT MEANING 

7 = Indicates terminal is online. 
1 = Indicates terminal is offline. 



= The device is online. This is always 
the status returned due to restriction 
of the Centronics interface. 



The device is not write-protected. 

The device is write-protected. 

The device is on! ine. 

The device is offline. 



1600 bpi. 

1 = 800 bpi or blank tape. If transport 
density is not selectable in software, 
tape density may not be accurate as 
reported in this status byte. The user 
must know the tape density if the 
transport density is controlled from 
front panel . 

= Transport density not selectable in 

software. 

1 = Transport density is selectable in 

software. 

= Device not write-protected. 

1 = Device is write-protected. 

= A Configure-and-Mount command has been 

received for the tape drive. 

1 = No Configure-and-Mount command has been 

received for the tape drive since bootup 
or last Configure-and-Dismount command. 
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3.5 CONFIGURATION PARAMETERS 

The following tables describe (for the specified device) each field in the 
parameter block of the Configure-Device, Configure-Defaults, and 
Configuration-Status requests. 

Values for each configuration parameter field are supplied by the user during 
the SYSGEN process and written into the default configuration table at system 
initialization. 



3.5.1 Terminal Configuration Parameter Block 

In general, when a character received by the driver is interpreted as having 
special meaning according to the current configuration setting, the action 
associated with that special meaning is performed and the character is 
discarded. For example, if the XOFF character is received by the driver, it 
usually is not in the user's read buffer. However, if the character has been 
defined as a read delimiter, it is placed in the requestor's buffer as data 
(assuming there is room). The length of the data transfer field in the 
requestor's I/O parameter block reflects the presence of the read delimiter 
for image mode read operations but not for formatted mode read operations. 
Figure 3-5 shows the terminal configuration parameter block. 

NOTE 

When changing the configuration for a serial port, do not 
assign any character more than one function. For example, 
if $13 (CTRL-S) is. configured as the XOFF character and the 
REPRINT LINE character, one of the two functions cannot 
work properly. 
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STATUS/ERROR 




$00 1 


CHANNEL TYPE CODE 




$01 1 


DEVICE TYPE CODE 




$02 1 


DRIVER CODE 




$03 1 


ATTRIBUTES MASK 




$04 1 


PARAMETERS MASK 




$05 1 


ATTRIBUTES WORD 




$08 1 


LINE WIDTH 





$0A 1 


LINES PER PAGE 


1 


$0C 1 


WRITE TIMEOUT 


2 


$10 1 


READ TIMEOUT 


3 


$14 1 


XOFF/XON CHARACTERS 


4 


$18 1 


BREAK EQUIVALENT 


5 


$1A 1 


DISCARD OUTPUT 


6 


$1B 1 


REPRINT LINE 


7 


$1C 1 


CANCEL LINE 


8 


$1D 1 


READ TERMINATORS 


9 


$1E 1 


END-OF-LINE STRING 


10 


$22 1 


BAUD RATE CODE 


11 


$25 1 


NULL PADDING 


12 


$27 1 


TERMINATOR-CLASS 


13 


$28 1 


TERMINAL CODE 


14 


$29 1 


RESERVED 




$2A 1 



RESERVED 



$43 



FIGURE 3-5. Configuration lOCB for Terminals 
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NOTE 

The number in the left number column above is the on/off bit 
in the parameters mask field that corresponds to that parameter. 



FIELD 
STATUS/ERROR 



DEFAULT 
VALUE 



IMAGE (I) 
FORMATTED (F) 



lOSCEC Equate 
CECCDO 



CECUAP 



CECTTI 



CECTIM 



CECTBR 



FIELD 
DESCRIPTION 

Configure-Device 
Configure-Defaults 
Configuration -Status 

On return from a request, this 
field contains the current 
device status unless the status 
field in the user's lOCB is $88 
(configuration error), in which 
case the returned status/error 
field contains a code that 
identifies the cause of the 
error. 

Code Device Status 

$01 Specified parameter/ 
attribute invalid for 
Configure-Device 
request. Use Configure- 
Defaults request. 

$02 Specified parameter/ 
attribute (Configure- 
Device/Configure- 
Defaults request) 
inval id for driver/ 
channel type. 

$40 Specified parameter/ 
attribute invalid for 
Read termination. 

$41 Parameter/attribute 
confl ict for modem 
operation. 

$42 Invalid baud rate 

specified for drive/ 
channel type or re- 
quested baud rate not 
configurable for 
driver/channel type. 
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DEFAULT IMAGE (I) FIELD 
FIELD VALUE FORMATTED (F) DESCRIPTION 

CHANNEL TYPE CODE Configure-Device 

Configure-Defaults 
Configuration-Status 



B 



This field contains on return 
from a request the code for the 
channel type. If an error is 
returned in the status/error 
field this field is reserved 
for future use. 

Examples of channel type codes 
are: 

$64 7201 A-side on MVME400 
$65 7201 B-side on MVME400 
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FIELD 

DEVICE TYPE CODE 



DEFAULT IMAGE (I) FIELD 
VALUE FORMATTED (F) DESCRIPTION 

Configure-Device 
Configure-Defaults 
Configuration -Status 

If status is returned in the 
status/error field, this field 
contains a code identifying the 
type of device. If an error is 
returned in the status/error 
field, this field is reserved 
for future use. 



B 



Code Device Type 
3 Terminal 



DRIVER CODE 



Configure-Device 
Configure-Defaults 
Configuration -Status 

On return from a request, 
this field contains the code 
for the driver type. If an 
error is returned in the 
status/error field this field 
is reserved for future use. 



Code 


Driver 






1 


Terminal 
ports 


driver for 


7201 


8 


Terminal 


driver 


for 




SCN2651 


ports 




$A 


Terminal 


driver 


for 




SCN2681 


ports 




$B 


Terminal 


driver 


for 



MK68901 ports 
$C Terminal driver for 

R58550 ports 
$D Terminal driver for ACIA 

ports 
$E Terminal driver for 

Mostek 68564 ports 
$11 Terminal driver for 

keyboard/screen on VME/10 
$20 IPC driver 
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FIELD 
ATTRIBUTES MASK 



B 



DEFAULT IMAGE (I) FIELD 
VALUE FORMATTED (F) DESCRIPTION 

Configure-Device 
Configure-Defaults 

A 1 in a particular bit 
position indicates to use the 
corresponding bit of the 
attributes word field to update 
the configuration. 

A indicates that the current 
attribute will be retained. An 
attempt to configure an 
unsupported attribute will 
result in an error. 



Configuration -Status 

A 1 in a bit position indicates 
that the driver supports the 
corresponding attribute. 
A indicates that the 
attribute is not supported by 
the driver. 



Bit 


Attribute 





Hardcopy 


1 


Use XOFF/XON 


2 


Bits per character 


3 


Stop bits 


4 


Parity usage 


5 


Type parity 


6 


Local echo 


7 


Type ahead 


8 


Terminate on buf 




full 


9 


Pass nulls 


10 


Modem/Direct connect 


11 


Modem off-hook 


12-15 


Reserved 
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FIELD 



PARAMETERS MASK 



DEFAULT IMAGE (I) FIELD 
VALUE FORMATTED (F) DESCRIPTION 



Configure-Device 
Configure-Defaults 

A 1 in a particular bit 
position indicates that the 
corresponding field from the 
parameter block should be used 
to update the configuration. 
A in a bit position indicates 
that the parameter value in 
the current configuration will 
be retained. Attempting to 
configure an unsupported 
attribute results in an error. 
The following bit/field 
correspondence is in effect: 



B 



Bit 



Field 






LINE WIDTH 


1 


LINE PER PAGE 


2 


WRITE TIMEOUT 


3 


READ TIMEOUT 


4 


XOFF/XON CHARACTERS 


5 


BREAK EQUIVALENT 


6 


DISCARD OUTPUT 


7 


REPRINT LINE 


8 


CANCEL LINE 


9 


READ TERMINATORS 


10 


END-OF-LINE STRING 


11 


BAUD RATE CODE 


12 


NULL PADDING 


13 


TERMINATOR-CLASS 


14 


TERMINAL TYPE 


15 


RESERVED 



Configuration-Status 

A 1 in a bit position indicates 

that the corresponding 

parameter is supported by the 

driver. 

A indicates that the 

parameter is not supported by 

the driver. 
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FIELD 



ATTRIBUTES WORD 



D 



LINE WIDTH 



LINES PER PAGE 



DEFAULT IMAGE (I) FIELD 
VALUE FORMATTED (F) DESCRIPTION 

Configure-Device 
Configure-Defaults 
Configuration -Status 

This field contains bit values 
which determine or reflect the 
terminal driver's behavior 
under specific circumstances. 
The values and their 
correspondence with terminal 
attributes are described in 
paragraph 3.4.2. 

80 F Configure-Device 

Configure-Defaults 

When a formatted Write to the 
terminal is completed, the 
driver checks to see if it has 
output a number of printable 
characters that is a multiple 
of the line width. If it has, 
the driver will not output the 
EOL string as it would 
normally. The assumption is 
that the terminal has done its 
own EOL processing since the 
last character output was in 
the last position of a line. 

Configuration-Status 

This field contains the current 
field value. 

24 F Configure-Device 

Configure-Defaults 

The number of printable lines 
on the terminal screen. This 
information is not currently 
used by the driver but is 
maintained so that a task could 
retrieve and use it. 

Configuration -Status 

This field contains the current 
field value. 
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FIELD 

WRITE TIMEOUT 



DEFAULT 
VALUE 

900,000 



IMAGE (I) 
FORMATTED (F) 

I,F 



READ TIMEOUT 



900,000 



I,F 



FIELD 
DESCRIPTION 

Configure-Device 

Illegal. An attempt to change 
this field using the Configure- 
Device request results in an 
error; use the Configure- 
Defaults request instead. 

Configure-Defaults 

The number of milliseconds lOS 
should allow for completion of 
a Write request before halting 
the I/O. 

The maximum value is equal to 
24 hours (86400000). Larger 
values will not generate an 
error but will result in a 24- 
hour timeout value. 

Configuration -Status 

This field contains the current 
field value. 

Configure-Device 

Illegal. An attempt to change 
this field using the Configure- 
Device request results in an 
error; use the Configure- 
Defaults request instead. 

Configure-Defaults 

The number of milliseconds lOS 
should allow for completion of 
a Read or Output-with-Input 
request before halting the I/O. 

The maximum value is equal to 
24 hours (86400000). Larger 
values will not generate an 
error but will result in a 24- 
hour timeout value. 

Configuration -Status 

This field contains the current 
field value. 



B 
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FIELD 
XOFF 



DEFAULT 
VALUE 

$13 
(CTRL S) 



IMAGE (I) 
FORMATTED (F) 

I,F 



B 



XON 



$00 I,F 
(Any Character) 



BREAK EQUIVALENT 



(CTRL C) 
($03) 



I,F 



FIELD 
DESCRIPTION 

Configure-Device 
Configure-DefauUs 

If the driver received this 
character, transmission is 
suspended until it receives the 
XON character. This is also 
the character sent by the 
driver to stop the terminal 
from transmitting if the 
XOFF/XON attribute is selected. 
If this byte is 0, there is no 
XOFF character. 

Configuration -Status 

This field contains the current 
field value. 

Configure-Device 
Configure-Defaults 

If transmission has been 
suspended by receipt of an XOFF 
character, receipt of the XON 
character resumes transmission. 
If this byte is 0, then any 
character resumes transmission. 
This is also the character sent 
by the driver to the device to 
allow it to transmit if the 
XOFF/XON attribute is selected. 

Configuration -Status 

This field contains the current 
field value. 

Configure-Device 
Configure-Defaults 

Receipt of this character is 
equivalent to receiving a break 
condition from the terminal. 
If this byte is there is no 
break equivalent character. 

Configuration-Status 

This field contains the current 
field value. 
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FIELD 



DISCARD OUTPUT 



DEFAULT 
VALUE 

$0F 
(CTRL 0) 



IMAGE (I) 
FORMATTED (F) 

I,F 



FIELD 
DESCRIPTIO N 

Configure-Device 
Configure-DefauUs 

Receipt of this 
causes all write 
terminal to be disc 
the condition is cl 
length -of -data- trans 
returned for the 
always the enti 
length, regardless 
CR characters. Thi 
can be cleared by: 



character 
s to the 
arded until 
eared. The 
fer 

write is 
re buffer 
of embedded 
s condition 



B 



a. The receipt of another 
discard-output character 
from the terminal (a 
toggle). 

b. The receipt of any Output- 
with-Input or Read request 
from the task. 

c. The receipt of a Write 
request with the option set 
to clear the discard output 
condition. 

If this byte is 0, there is no 
discard output character. 



REPRINT LINE 



$04 
(CTRL D) 



Configuration- Status 

This field contains the current 
field value. 

Configure-Device 
Configure-Defaults 

In response to a Read request, 
this character redisplays on 
the next line what has been 
typed so far. If this byte is 
0, there is no reprint line 
character. 

Configuration -Status 

This field contains the current 
field value. 
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FIELD 



CANCEL LINE 



DEFAULT 
VALUE 

$18 
(CTRL X) 



IMAGE (I) 
FORMATTED (F) 



B 



READ TERMINATORS 



SODDEOOOO I,F 
(CR ..) 



FIELD 
DESCRIPTION 

Configure-Device 
Configure-Defaults 

In response to a Read request, 
this character discards what 
has been typed so far. If this 
byte is 0, there is no cancel - 
1 ine character. 

Configuration -Status 

This field contains the current 
field value. 

Configure-Device 
Configure-Defaults 

The characters specified in 
this string, when received in 
response to a Read operation, 
are interpreted as terminators. 
A match on any character in 
this field terminates the Read. 
The user may specify to 4 
characters as terminators. 
Incoming characters are edited 
against each character in this 
field until all characters have 
been examined or until trailing 
zeros are encountered. A data 
string of $00000000 indicates 
that there are no read 
terminators. 

Configuration -Status 

This field contains the current 
field value. 
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FIELD 

END-OF-LINE 
STRING 



DEFAULT 
VALUE 

$ODOAOOOO 
(CR LF) 



IMAGE (I) 
FORMATTED (F) 



BAUD RATE CODE 



$0E 



I,F 



FIELD 
DESCRIPTION 

Configure-Device 
Configure-Defaults 

The characters specified in 
this string are echoed when a 
terminator is received during a 
formatted Read operation and 
are sent after each formatted 
Write operation unless an exact 
multiple of the line width is 
reached. The terminator itself 
is not echoed. Characters are 
sent until either all have been 
sent or trailing zeros are 
encountered. A $00000000 data 
string indicates no EOL string. 

Configuration -Status 

This field contains the current 
field value. 

Configure-Device 
Configure-Defaults 

The codes to indicate the baud 
rate are: 



D 



Code 


Rate 


$00 


50 


$01 


75 


$02 


110 


$03 


134.5 


$04 


150 


$05 


300 


$06 


600 


$07 


1200 


$08 


1800 


$09 


2000 


$0A 


2400 


$0B 


3600 


$0C 


4800 


$0D 


7200 


$0E 


9500 


$0F 


19200 


$10 


38400 


$10-FF 


Reserved 


Configuration -Status 


This field 


contains the current 


field value 


, 
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FIELD 

NULL PADDING 



DEFAULT 
VALUE 

$00 



IMAGE (I) 
FORMATTED (F) 

I,F 



B 



TERMINATOR-CLASS 



$00 



I,F 



FIELD 
DESCRIPTION 

Configure-Device 
Configure-Defaults 

This number, maximum of 255, 
represents the number of ASCII 
NUL characters that will be 
sent following each CR or LF 
character transmitted by the 
driver. 

Configuration -Status 

This field contains the current 
field value. 

Configure-Device 
Configure-Defaults 

This field provides the user 
the ability to terminate Read 
operations by defining a range 
of values to act as read 
terminators. The field is 
divided into two subfields 
represented by the high-order 4 
bits, the Don't Care Mask, and 
the low-order 4 bits, the Match 
Value. The operations 
described below do not alter 
the original character being 
processed. If the Don't Care 
Mask has a value of 0, it 
implies that there is no 
terminator class and the 
following operations will not 
be performed. 

The Don't Care Mask is ANDed 
with the high-order 4 bits of 
the incoming character. Then a 
comparison is made of the ANDed 
result with the match value 
subfield. If equal, the 
character being processed is a 
terminator character. 

Configuration -Status 

This field contains the current 
field value. 
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FIELD 
TERMINAL CODE 



DEFAULT 
VALUE 

$00 



IMAGE (I) 
FORMATTED (F) 

I,F 



FIELD 
DESCRIPTION 

Configure-Device 
Configure-Defaults 

This field is maintained by the 
driver but is not used by it. 

Configuration -Status 

This field contains the current 
field value. 

Code Terminal Type 

$00 EXORterm 155, VME/10 
$01-$7F Reserved 
$80-$FF User defined 




3.5.2 Terminal Attributes Word Field 

A detailed description of the terminal attributes word field follows. 

DEFAULT IMAGE (I) 
ATTRIBUTE BIT VALUE FORMATTED fF) BIT DESCRIPTION 



Hardcopy 



Controls the way a backspace 
($08) or delete ($7F) character 
is echoed in formatted mode. 



Back up 
character. 



and erase the 



1 = Show the deleted characters 
between angle brackets in a 
suitable way for hard copy 
devices. For example, 
abcd<BS><BS><BS>e would 
echo abcd<dcb>e. 

The way the cancel line 
function is done also changes: 

= Back up and erase all the 

characters on the line. 

1 = Output a backslash and go 

down to the next 1 ine. 
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ATTRIBUTE BIT 
XOFF/XON 1 



B 



Bits/character 2 



Stop bits 3 



Parity 



4,5 



Local echo 5 



Type ahead 7 



DEFAULT IMAGE (I) 
VALUE FORMATTED (F) BIT DESCRIPTION 



I,F 



I,F 



I,F 



00 



I,F 



I,F 



I,F 



Determines what the driver will 
use to suspend and resume 
transmission from the terminal. 
Modem operation requires that 
the XOFF/XON bit value = 1. 

= Use the GTS line. 

1 = Use the XOFF/XON characters 

= Transmit and receive 8 data 

bits per character. 

1 = Transmit and receive 7 data 

bits per character. 

= Follow each character 

transmitted with one stop 
bit. 

1 = Follow each character 

transmitted with two stop 
bits. 

= Do not check parity. 

1 = Do not check parity and 
drop bit 7. 

10= Generate and check odd 
parity. 

11= Generate and check even 
parity. 

= Echo characters received 

from the terminal, unless 
the user's read operation 
has requested that echo be 
suppressed via an option in 
the I/O parameter block. 

1 = Do not echo characters 

received from the terminal. 

= Buffer the characters 
received from the terminal 
if a read operation is not 
being processed. If buffer 
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ATTRIBUTE 



BIT 



DEFAULT 
VALUE 



IMAGE (I) 
FORMATTED (F) 



Terminate 8 
on buffer full 



I,F 



BIT DESCRIPTION 

overflow did not occur, the 
buffered characters will be 
processed when the current 
operation is complete. 

1 = Discard the characters 
received from the terminal 
if a read operation is not 
being processed. 

= Echo the BEL character for 
each excessive character 
when the user attempts to 
overfill the read buffer. 



B 



Pass nulls 



Modem/direct 
connect 



10 



I,F 



1 = Terminate the read 
operation when the read 
buffer becomes full. 
Characters typed after 
termination of the read 
operation will be placed in 
the type-ahead buffer if 
the type-ahead option is 
enabled; otherwise, the 
characters are discarded. 

= During image mode reads, 

discard ASCII NUL ($00) 
characters. 

1 = During image mode reads, 

place ASCII NUL characters 
into the buffer. 

Formatted mode reads always 
discard ASCII NUL characters. 

Used to designate whether the 
port is connected to a terminal 
directly or through a modem. 
If the modem bit value is 1, 
the XOFF/XON bit value must 
also be 1. 

= Port is connected to a 

terminal . 

1 = Port is connected to a 

modem. 
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DEFAULT IMAGE (I) 

ATTRIBUTE BIT VALUE FORMATTED (F) BIT DESCRIPTION 

Modem off 11 I,F Used to control the DTR output 

hook on the port when connected to a 



B 



90 



modem. 



DTR should be high, 
allowing modem to answer 
phone and establish a 
connection. 

DTR should be low, 
preventing modem from 
answering phone. If a 
connection is currently 
established, modem hangs up 
phone. 



12-15 Reserved 
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3.5.3 Printer Configuration Parameter Block 
Figure 3-6 shows the Printer Configuration Block. 



STATUS/ERROR 




$00 1 


CHANNEL TYPE CODE 




$01 i 


DEVICE TYPE CODE 




$02 1 


DRIVER CODE 




$03 1 


ATTRIBUTES MASK 




$04 1 


PARAMETERS MASK 




$06 1 


ATTRIBUTES WORD 




$08 1 


LINE WIDTH 





$0A 1 


LINES PER PAGE 


1 


$0C 1 


WRITE TIMEOUT 


2 


$10 1 


RESERVED 


3 


$14 1 


LOGICAL LINE WIDTH 


4 


$18 1 


EOL CHARACTER 


5 


$1A 1 


RESERVED 




$1B 1 



RESERVED 



B 



$43 



NOTE: The number in the left number column above is the on/off bit in the 
parameters mask field that corresponds to that parameter. 



FIGURE 3-6. Configuration lOCB for Printers 
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DEFAULT IMAGE (I) FIELD 
FIELD VALUE FORMATTED (F) DESCRIPTION 

STATUS/ERROR Configure-Device 

Configure-Defaults 
Configuration -Status 

On return from a request, this 
field contains the current 
device status unless the status 
field in the user's lOCB is 
nonzero in which case the 
returned status/error field 
contains a code identifying the 
cause of the error. 



lOSCEC Equate 
CECCDO 



CECUAP 



CECPNI 

CECPRLZ 

CECPLGP 



Code Device Status 

$01 Specified parameter/attri- 
bute invalid for Con- 
figure-Device request. Use 
Configure-Defaults request. 

$02 Specified parameter/attri- 
bute (Configure-Device/ 
Configure-Defaults request) 
invalid for driver/channel 
type. 

$40 A NUL is an invalid EOL 
character. 

$41 Logical and/or physical 
line width is zero. 

$42 Logical line width exceeds 
physical line width. 
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FIELD 

CHANNEL TYPE CODE 



DEFAULT 
VALUE 



IMAGE (I) FIELD 
FORMATTED (F) DESCRIPTION 

Configure-Device 

Configure-Defaults 

Configuration-Status 

On return from a request, this 
field contains the code for the 
channel type. If an error is 
returned in the status/error 
field, this field is reserved 
for future use. 



B 



Code 



$11 



Type Channel 

MCCM IPC printer 
ports $50-$5F 



DEVICE TYPE CODE 



$50 


EXORmacs PIA 


$51 


VMOl parallel 


$52 


RTTLIO parallel 


$53-$5F 


Reserved 


Configure- 
Configure- 
Configurat 


Device 
Defaults 
-ion-Status 



If status is returned in the 
status/error field, this field 
contains a code identifying the 
type of device. If an error is 
returned in the status/error 
field, this field is reserved 
for future use. 



Code 
4 



Device Type 
Printer 
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FIELD 
DRIVER CODE 



B 



DEFAULT IMAGE (I) FIELD 
VALUE FORMATTED (F) DESCRIPTION 

Configure-Device 
Configure-DefauUs 
Configuration -Status 

On return from a request, this 
field contains the code for the 
driver type. If an error is 
returned in the status/error 
field, this field is reserved 
for future use. 

Code Driver 

2 Printer driver for 
local PIA port 

$20 IPC driver 



ATTRIBUTES MASK 



Configure-Device 
Configure-Defaults 

A 1 in a particular bit posi- 
tion indicates that the 
corresponding bit of the 
attributes word field be used 
to update the configuration. 
A indicates that the current 
attribute will be retained. 

Configuration -Status 

A 1 in a bit position indicates 
that the driver recognizes the 
corresponding attribute. 
A indicates that the attri- 
bute is not recognized by the 
driver. 

Bit Attribute 

Auto-LF 

1 Form feed before print 

2 Truncate/wraparound 
Print at logical line 
width 

3-15 Reserved 
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FIELD 



PARAMETERS MASK 



DEFAULT IMAGE (I) FIELD 
VALUE FORMATTED (F) DESCRIPTION 

Configure-Device 
Configure-Defaults 

A 1 in a particular bit posi- 
tion indicates that the 
corresponding field from the 
parameter block should be used 
to update the configuration. 
A in a bit position indicates 
that the parameter value in 
the current configuration will 
be retained. The bit/field 
correspondence in effect is: 



B 



Bit 



Field 






Line width 


1 

2 
3 
4 
5 
6-16 


Lines per page 

Write timeout 

Reserved 

Logical line width 

End-of-line character 

Reserved 



Configuration-Status 

A 1 in a bit position indicates 
that the driver recognizes the 
corresponding parameter. 
If bit is 0, the driver does 
not recognize the parameter. 



ATTRIBUTES WORD 



Configure-Device 

Configure-Defaults 

Configuration-Status 

This field contains bit values 
which determine or reflect the 
printer driver's behavior under 
specific circumstances. The 
values and their correspondence 
with printer attributes are 
described in paragraph 3.5.4. 
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FIELD 


DEFAULT 
VALUE 


IMAGE (I) 
FORMATTED (F) 


FIELD 
DESCRIPTION 


LINE WIDTH 


132 


F 


Configure-Device 
Configure-Defaults 
Configuration -Status 



B 



This value defines the number 
of printable characters that 
can be printed on one physical 
printer 1 ine. 

FORMATTED MODE: 

In this mode, non-printing 
characters are passed to the 
printer but are not counted as 
part of the physical line width 
nor as part of the data 
transfer length. After each 
printable character is sent to 
the printer, a test is made to 
determine if the number of 
printed characters is a 
multiple of the physical line 
width. No action is taken if a 
multiple has not been printed. 
If the number is a physical 
line width multiple and the 
auto-LF attribute is off, the 
driver sends an LF character. 
If the auto-LF attribute is on, 
the driver assumes the printer 
will do the appropriate EOL 
processing. The physical line 
width may not be 0. 

IMAGE MODE: 

In this mode, the line width is 
ignored. After completion of 
the request, the data transfer 
length returned is the length 
of the data buffer. 
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FIELD 

LINES PER PAGE 



DEFAULT IMAGE (I) FIELD 
VALUE FORMATTED (F) DESCRIPTION 

66 Configure-Device 

Configure-Defaults 
Configuration -Status 

This value, number of lines on 
the printer page, is not 
currently used by the driver 
but is maintained so that a 
task can retrieve and use the 
information. 




WRITE TIMEOUT 



I,F 



Configure-Device 

Illegal. An attempt to change 
this field using the Configure- 
Device request results in an 
error. The Configure-Defaults 
request should be used instead. 

Configure-Defaults 
Configuration -Status 

This field contains the number 
of milliseconds lOS should 
allow for completion of a Write 
request before halting the I/O. 
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FIELD 



DEFAULT 
VALUE 



LOGICAL LINE WIDTH 132 



B 



IMAGE (I) FIELD 
FORMATTED (F) DESCRIPTION 

F Configure-Device 
Configure-Defaults 
Configuration -Status 

Logical line width must be less 
than or equal to the physical 
line width. 

FORMATTED MODE: 

When the logical line width is 
equal to the physical line 
width, the driver behaves the 
same as the physical line width 
parameter. 

When the logical line width is 
less than the physical line 
width, the driver operates as 
follows: 

Non-printing characters are 
passed to the printer but not 
counted as part of the logical 
line width or the data transfer 
length. After each printable 
character has been sent to the 
printer, a test is made to 
determine if the number of 
characters printed is an exact 
multiple of the logical line 
width. If so, and the auto-LF 
attribute is also set, an EOL 
character is sent. 

If auto-LF is not set, an LF, 
CR sequence is sent. If the 
number of characters is not an 
exact multiple of the logical 
line width, no LF, CR sequence 
is sent. Following one of the 
above actions, printing either 
resumes or terminates according 
to the setting of the 
wraparound/truncate printer 
attribute. 
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FIELD 



DEFAULT IMAGE (I) FIELD 
VALUE FORMATTED (F) DESCRIPTION 



LOGICAL LINE WIDTH 132 



EOL CHARACTER 



$0A 
(LF) 



FORMATTED MODE (cont'd) 

In general, formatting is 
provided to match what would be 
produced if the carriage length 
of the printer were the same as 
the logical line width. For 
example, if using a 132-column 
printer, a logical line width 
of 80 provides formatting as 
though an 80-column printer 
were being used. 

IMAGE MODE: 

In image mode, the logical line 
width is ignored and the data 
transfer length returned after 
completion of the request is 
the length of the data buffer. 

Configure-Device 
Configure-Defaults 
Configuration -Status 

FORMATTED MODE: 

On completion of a write due to 
an embedded CR in the data 
buffer or reaching the end of 
the data buffer, a test is 
performed to determine if the 
data transfer length is a 
multiple of the logical line 
width. If it is a multiple, no 
further action occurs. 
Completed writes whose data 
transfer length is not a 
multiple of the logical line 
width cause the driver to send 
the EOL character to the 
printer if the auto-LF 
attribute has been selected; 
otherwise, an LF, CR sequence 
is sent to the printer. The 
NUL character is not a valid 
EOL character. 

IMAGE MODE: 

The EOL character is not used. 



H 
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3.5.4 Printer Attributes Word Field 

A detailed description of the printer attributes word field is provided below. 



B 



ATTRIBUTE 
Auto-LF 



BIT 




DEFAULT IMAGE (I) 
VALUE FORMATTED (F) BIT DESCRIPTION 



Used to control EOL processing 




1 



Printer does not support 
automatic line feed. 

Printer supports automatic 
line feed. 



Form feed 
after assign 



I,F 



Truncate/ 2 
wraparound 
(print at logical 
1 ine width) 



Used to determine whether a 
form feed ($0C) is to be sent 
before the first write after 
assign. 

= Form feed is output before 

first write after assign. 

1 = No form feed is sent. 

Used to terminate a print 
request when the logical line 
width is reached or to continue 
printing on the next line. 

= Continue printing on the 

next line when the logical 
line width is reached. 

1 = Terminate the print request 

when the logical line width 
is reached. 



3.5.5 Disk Configuration Parameter Block 



The Configure-Dev 
Peripheral Control 
Configuration -Statu 
attributes-mask fi 
parameters may be 
Device and Config 
attributes-mask fi 
random access devi 
media. Figure 3-7 



ice and Configure-Defaults requests for Intelligent 
ler (IPC) random access devices (VM21) are treated as if a 
s request had been made. The parameters-mask field and the 
eld must contain zeros. None of the IPC disk configuration 
changed. For non-IPC random access devices, the Configure- 
ure-Defaults commands require the parameters-mask field and 
eld to be set correctly. The status command for non-IPC 
ces returns the actual configuration for the device and the 
shows the configuration parameter block. 
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STATUS/ERROR 




$00 1 


CHANNEL TYPE CODE 




$01 1 


DEVICE TYPE CODE 




$02 1 


DRIVER CODE 




$03 1 


ATTRIBUTES MASK 




$04 1 


PARAMETERS MASK 




$06 1 


ATTRIBUTES WORD 




$08 1 


VERSAdos SECTOR SIZE 





$0A 1 


TOTAL NUMBER OF 


1 


$0C 1 


VERSAdos SECTORS 






WRITE TIMEOUT 


2 


$10 1 


READ TIMEOUT 


3 


$14 1 


PHYSICAL SECTORS/TRACK 


4 


$18 1 


ON MEDIA 






NUMBER HEADS 


5 


$19 1 


NUMBER CYLINDERS 


6 


$1A 1 


ON MEDIA 






INTERLEAVE FACTOR 


7 


$1C 1 


ON MEDIA 






SPIRAL OFFSET 


8 


$1D 1 


ON MEDIA 






PHYSICAL SECTOR SIZE 


9 


$1E 1 


ON MEDIA 






STARTING HEAD NUMBER 


10 


$20 1 


OF DRIVE 






NUMBER OF CYLINDERS 


11 


$22 1 


ON DRIVE 






PRECOMPENSATION VALUE 


12 


$24 1 


PHYSICAL SECTORS/TRACK 


13 


$26 1 


ON DRIVE 






STEPPING RATE CODE 


14 


$27 1 


REDUCED WRITE CURRENT 


15 


$28 1 


CYLINDER NUMBER 






ECC DATA BURST LENGTH 


15 


$2A 1 


RESERVED 




$2C 1 



B 



FIGURE 3-7. Configuration lOCB for Disks 
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NOTE: The number in the left number column above is the bit in the 
parameter-mask field that corresponds to that parameter. 



B 



DEFAULT FIELD 
FIELD VALUE DESCRIPTION 

STATUS/ERROR Configure-Device 

Configure-Defaults 
Configuration-Status 

On return from a request, this field contains the 
current device status unless the status field in 
the user's lOCB is nonzero, in which case the 
returned status/error field contains a code 
identifying the cause of the error. 

lOSCEC Equate Code Device Status 

CECDAP $40 Configuration error. Specified 
parameter not recognized by the 
drive/channel type. 

CECDIA $41 Specified attribute not recognized 
by the drive/channel type. 

CECDIW $42 Invalid attributes word specified; 
conflict between hard disk/floppy 
disk. 

CECDII $43 Invalid interleave factor specified 
for the drive/channel type. 

CECDSS $44 Invalid sector size specified for 
the drive/channel type. 

CECDST $45 Invalid sectors per track specified 
for the drive/channel type. 

CECDDS $45 Invalid disk size specified for the 
drive/channel type. 

CECDFC $47 Invalid floppy disk configuration 
specified for the drive/channel 
type. 
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FIELD 



CHANNEL TYPE CODE 



DEFAULT FIELD 
VALUE DESCRIPTION 

Configure-Device 
Configure-Defaults 
Configuration -Status 

On return from a request, this field contains the 
code for the channel type. If an error is 
returned in the status/error field this field is 
reserved for future use. 

Code Type Channel 

$10 VM20/VM21 disk IPC 

$12 VM22 disk controller 

$20 M420 on I/O Channel 

$21 RWIN I/O Channel 

$23 MVME315 disk controller 

$25 MVME320 disk controller 




DEVICE TYPE CODE 



Configure-Device 

Configure-Defaults 

Configuration-Status 

If status is returned in the status/error field, 

this field contains a code identifying the type of 

device. If an error is returned in the 

status/error field, this field is reserved for 
future use. 



Code 

1 
2 



Device Type 

Floppy disk 
Rigid disk 



DRIVER CODE 



Configure-Device 
Configure-Defaults 
Configuration- Status 

On return from a request, this field contains the 
code for this driver type. If an error is 
returned in the status/error field, this field is 
reserved for future use. 



Code 



Driver 



3 
4 
5 
9 
$20 
$21 



M420 disk driver on I/O Channel 
RWIN disk driver on I/O Channel 
MVME315 disk driver 
MVME320 disk driver 
VM20/VM21 disk IPC driver 
VM22 disk driver 
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FIELD 



DEFAULT 
VALUE 



FIELD 
DESCRIPTION 



ATTRIBUTES MASK 



D 



None Configure-Device 
Configure-Defaults 

A 1 in a particular bit position indicates that 
the corresponding bit of the attributes word field 
should be used to update the configuration. 
A indicates that the current attribute is 
retained. An attempt to configure an unsupported 
attribute results in an error. The attribute mask 
bits currently defined are: 



Bit 


Field 





Data density 


1 


Track density 


2 


Side/diskette 


3 


Format type 


4 


Disk type 


5 


Disk data density capability 


6 


Drive track density capability 


7 


Embedded servo drive seek 


8 


Post-read/Pre-write precompensation 


9 


Floppy disk size 


10 


Alternate sector capability 


11-15 


Reserved 



PARAMETERS MASK 



Configuration -Status 

A 1 in a bit position indicates that the driver 
supports the corresponding attribute. 
A indicates that the attribute is not supported 
by the driver. 

None Configure-Device 
Configure-Defaults 

A 1 in a particular bit position indicates that 
the corresponding parameter from the parameter 
block should be used to update the configuration. 
A in a bit position indicates that the parameter 
value in the current configuration will be 
retained. Attempting to configure an unsupported 
parameter results in an error. 
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FIELD 
PARAMETERS MASK 



DEFAULT 
VALUE 

None 



ATTRIBUTES WORD 



None 



FIELD 
DESCRIPTION 

(cont'd) 

The bit/field correspondent in effect is: 

Bit Field 

VERSAdos sector size 

1 VERSAdos total number of sectors 

2 Write timeout 

3 Read timeout 

4 Sectors per track 

5 Number of heads on drive 

6 Number of cylinders 

7 Interleave factor 

8 Spiral offset 

9 Physical sector size 

10 Starting head number on drive 

11 Number of cylinders on drive 

12 Precompensation cylinder number 

13 Sectors per track supported by drive 

14 Stepping rate code 

15 Reduced write current cylinder number and 
ECC data burst length 

Configuration-Status 

A 1 in a bit position indicates that the driver 
recognizes the corresponding parameter. 
A indicates that the parameter is not recognized 
by the driver. 

Configure-Device 
Configure-Defaults 




This field contains 
attributes of the med 
by the driver). The 
the attributes mask 
A 1 in a particular b 
mask indicates to 
the corresponding 
field. 

A in a particular 
mask indicates that 
retained. 



bit values defining all the 
ia (even those not recognized 
attributes word is used with 
to update the configuration, 
it position in the attributes 
update the configuration with 
it of the attributes word 

it position in the attributes 
the current attribute will be 
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FIELD 
ATTRIBUTES WORD 



B 



VERSAdos 
SECTOR SIZE 



VERSAdos 
TOTAL SECTORS 



WRITE TIMEOUT 



DEFAULT FIELD 
VALUE DESCRIPTION 

None (cont'd) 

Configuration -Status 

This field contains the current field value. It 
is important to realize that the attributes word 
contains the bit values defining all attributes of 
the media independent of the attributes mask. 
This is essential when using removable media on 
more than one drive/channel type. The bits and 
their corresponding disk attributes are listed 
under ATTRIBUTES MASK and described in paragraph 
3.5.6. 

None Configure-Device 
Configure-Defaults 

This field defines the number of bytes in a 
VERSAdos sector. The only value supported is 256. 
This field is returned by the driver. 

Configuration-Status 

This field contains the current field value. 

None Configure-Device 
Configure-Defaults 

This field is calculated and returned by the 
driver based on the sectors per track, number of 
cylinders, and number of surfaces specified for 
the media. It represents the total number of 
VERSAdos sectors available on the media. 

Configure-Device 

Illegal. An attempt to change this field results 
in an error; use the Configure-Defaults request 
instead. 

Configure-Defaults 

The number of milliseconds lOS should allow for 
completion of a Write request before halting I/O. 
This feature is currently supported by the 
VM20/VM21 IPC disk controller driver. 

Configuration- Status 

This field contains the current field value. 
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FIELD 



READ TIMEOUT 



DEFAULT 
VALUE 



SECTORS/TRACK 
ON MEDIA 



None 



NUMBER OF HEADS 



None 



FIELD 
DESCRIPTION 

Configure-Device 

Illegal. An attempt 
result in an error; 
request instead. 

Configure-Defaults 



to change this field will 
use the Configure-Defaults 



The number of milliseconds lOS should allow for 
completion of a Read request before halting I/O. 
This feature is currently supported by the 
VM20/VM21 IPC disk controller driver. 

Configuration -Status 

This field contains the current field value. 

Configure-Device 
Configure-Defaults 

This field defines the number of physical sectors 
rormatted on a track of media. The number must be 
accurately given based on the type of media used. 
This field is used in determining the total number 
of VERSAdos sectors on the media. 

Configuration-Status 

This field contains the current field value. 

Configure-Device 
Configure-Defaults 

This field defines the physical number of heads on 
the drive and is used to determine the number of 
recording surfaces for hard disks only. This 
field is also used in determining the total number 
of VERSAdos sectors on the media for hard disks 
only. 

Configuration -Status 

This field contains the current field value. 



B 
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FIELD 

NUMBER OF 
CYLINDERS 
ON MEDIA 



B 



INTERLEAVE FACTOR 



SPIRAL OFFSET 



DEFAULT FIELD 
VALUE DESCRIPTIO N 

None Configure-Device 
Configure-DefauUs 

This field contains the number of cylinders across 
a single surface of the media. The number must be 
accurately given based on the type of media. It 
is also used in determining the total number of 
VERSAdos sectors on the media. 

Configuration-Status 

This field contains the current field value. 

1 Configure-Device 

Configure-Defaults 

This field defines the number of physical sectors 
between logically staggered sector numbers on a 
track. An interleave factor greater than one is 
used when the disk controller cannot transfer 
contiguous sectors. This field is actively used 
during the format process of the media. 

Configuration-Status 

This field contains the current field value. 

None Configure-Device 

Configure-Defaults 

This field defines a vertical stagger of physical 
sector numbers on a track for a given surface. 
The spiral offset value is the number of sectors 
to skip when selecting the next surface in a 
vertical step. This field is actively used during 
the format process of the media. 

Configuration-Status 

This field contains the current field value. 
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FIELD 

PHYSICAL SECTOR 
SIZE ON MEDIA 



STARTING HEAD 
NUMBER ON DRIVE 



NUMBER OF 
CYLINDERS 
ON DRIVE 



DEFAULT FIELD 
VALUE DESCRIPTION 

None Configure-Device 
Configure-Defaults 

This field defines the number of bytes in a 
physical sector on the media. Currently, the only 
valid values are 128 and 256 bytes per sector 
corresponding to single data density and double 
data density, respectively. These values must be 
defined to be consistent with the data density bit 
in the attributes word. The driver returns an 
error if there is a conflict. 

Configuration-Status 

This field contains the current field value. 

Configure-Device 
Configure-Defaults 

This field defines the starting head number for 
the logical unit for dual volume Storage Module 
Drives (SMD) when supported by the disk 
controller. 

Configuration -Status 

This field contains the current field value. 

None Configure-Device 
Configure-Defaults 

This field defines the maximum number of cylinders 
on the media that the drive unit can support. For 
non-removable media, this field is meaningless. 

Configuration -Status 

This field contains the current field value. 



B 



PRECOMPENSATION 
CYLINDER NUMBER 



None Configure-Device 
Configure-Defaults 

This field defines the cylinder number of the 
media at which precompensation begins when 
supported by the disk controller. Unless 
specifically defined by the drive manufacturer, a 
value equal to one-half the number of cylinders on 
the media is satisfactory. 

Configuration-Status 

This field contains the current field value. 
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FIELD 

NUMBER OF PHYSICAL 
SECTORS PER TRACK 
ON DRIVE 



B 



STEPPING RATE CODE 



DEFAULT FIELD 
VALUE DESCRIPTIO N 

None Configure-Device 
Configure-Defaults 

This field defines the maximum number of physical 
sectors per track on the media that the drive unit 
can support. This field is not supported by any 
of the current disk drivers. 

Configuration-Status 

This field contains the current field value. 

Configure-Device 
Configure-Defaults 

This field defines the stepping rate code of the 
head on the drive unit when supported by the disk 
controller. The code is translated into a 
stepping rate in milliseconds by the driver or 
disk controller for the following disk types: 

Step Rate Winchester 5-1/4 inch 8-inch 
Code Hard Disks Floppy Drive Floppy Drive 



Default 



REDUCED WRITE 
CURRENT CYLINDER 
NUMBER 



None 



000 


msec 


12 msec 


5 msec 


001 


6 msec 


5 msec 


3 msec 


010 


10 msec 


12 msec 


5 msec 


on 


15 msec 


20 msec 


10 msec 


100 


20 msec 


30 msec 


15 msec 



Configuration-Status 

This field contains the current field value. 

Configure-Device 
Configure-Defaults 

This field defines the cylinder number of the 
media at which reduced write current begins when 
supported by the disk controller. Unless 
specifically defined by the driver manufacturer, a 
value greater than the number of cylinders should 
be specified to indicate reduced write current 
precompensation is not used. Otherwise the 
precompensation begins at cylinder zero. 

Configuration -Status 

This field contains the current field value. 
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FIELD 

ECC DATA 
BURST LENGTH 



DEFAULT FIELD 
VALUE DESCRIPTION 

None Configure-Device 
Configure-Defaults 

This field defines the number of bits to correct 
for an ECC error when supported by the disk 
controller. 

Configuration -Status 

This field contains the current field value. 



B 



3.5.6 Disk Attributes Word Field 

A detailed description of the disk attributes word field follows. 



DEFAULT 
ATTRIBUTE BIT VALUE BIT DESCRIPTION 



Data density 



Track density 1 



Side/diskette 2 



Used to determine the encoding method of a 
track of data. This is determined by the 
formatting method. This bit must be set to 
be consistent with the parameter block sector 
size field. 

= FM encoding (single data density, 128 

bytes/sector) 

1 = MFM encoding (double data density, 255 

bytes/sector) 

Used to define the density across a recording 
surface. This usually relates to the number 
of tracks per inch. 

= Single density 

1 = Double density 

Used to determine if a single- or double- 
sided diskette is mounted on a drive. 

= Single sided diskette 

1 = Double sided diskette 
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ATTRIBUTE 
Format 



B 



Disk type 



Drive data 

Density 

Capability 



Drive track 
Density 
Capabil ity 

Embedded 
servo drive 
seek 



BIT 
3 



DEFAULT 
VALUE 



Post-read/ 8 

pre-write 

pre-compensation 



Floppy disk 
size 



Alternate 10 
Sector Capabil ity 



BIT DESCRIPTION 

Defines the type of format on the media. The 
Motorola format is a nonstandard format. 

= Motorola format 

1 = Standard IBM format 

= Floppy disk 

1 = Rigid disk 

= FM (single data density) drive encoding 

capability 

1 = MFM (double data density) drive encoding 

capability 

= Single density capability 

1 = Double density capability 



Causes a seek to occur following a head 
change (SMD drive only). 

= Drive does not require a seek when a head 

switch is performed. 

1 = Drive requires a seek when a head switch 

is performed. 

Used to define the pre-compensation cylinder 
number (when supplied) as post-read or pre- 
write. 

= Pre-write 

1 = Post-read 

Defines the size of the media. 

= 5-1/4 inch floppy disk 

1 = 8-inch floppy disk 

Used to determine whether the disk driver 
supports alternate sector handling. 

= No support 

1 = Supports alternate sector handling 



3.5.7 Media Attribute Table 

Table 3-9 lists the media files (.SI) from User 9998 (null catalog), the media 
related attributes values, and a cross-reference displaying which media files 
can be used with the currently supported disk controllers. 
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TABLE 3-9. Media Attribute Table 
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3.5.8 Disk Controller Attribute Table 

Table 3-10 is a cross-reference displaying the controller related attributes 
for the currently supported disk controllers. 



TABLE 3-10. Disk Controller Attribute Table 



B 




^attribute! 

TABLE^ 



CHAN ID 



ATT MASK hard disk 



ATT h^lASK floppy disk 



PAR MASK 



INTERLEAVE hard disk 



z 



WIND 



0410 



001F 



1AF3 



INTERLEAVE floppy disk 



ECC LEN 



Si 



SASS 



0015 



0015 



02F3 



55 



SAS8 



0210 



0215 



02F3 



13 



< 



Tl 

n 



CFD1 



N/A 



03FF 



FFF3 



n/a 



< 



c 
o 
n 



CUD1 



03FF 



03FF 



FFF3 



< 

IS9 



VI122 



0490 



025F 



5FF3 



< 

m 

CO 

(n 



11315 



0110 



021F 



DBF3 



11 



< 

m 

o 



M320 



0210 



0215 



53F3 



11 
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3.5.9 Magnetic Tape Configuration Parameter Block 

The Magnetic Tape Configuration Parameter Block is shown in Figure 3- 



STATUS/ERROR 




$00 


CHANNEL TYPE CODE 




$01 


DEVICE TYPE CODE 




$02 


DRIVER CODE 




$03 


ATTRIBUTES MASK 




$04 


PARAMETERS MASK 




$06 


ATTRIBUTES WORD 




$08 


VERSAdos SECTOR SIZE 





$0A 


TOTAL NUMBER OF 

VERSAdos SECTORS 
WRITE TIMEOUT 


1 
2 


$0C 
$10 


READ TIMEOUT 


3 


$14 


DENSITY REQUESTED 


4 


$18 


NUMBER OF READ TRIES 


5 


$19 


NUMBER OF WRITE TRIES 


6 


$1A 


NUMBER OF ERASURES 


7 


$1B 


TIMEOUT FOR TAPE READ 


8 


$1C 


TIMEOUT FOR SPACE 9 
FORWARD OR SPACE REVERSE 
TIMEOUT FOR REWIND $A 


$20 

$24 



TIMEOUT FOR SEARCH $B $28 

FORWARD OR REVERSE FOR FILEMARK 

RESERVED $2C 



RESERVED 



RESERVED 



$2D 



$43 



B 



FIGURE 3-8. Configuration lOCB for Magnetic Tape 
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D 



NOTE: The number in the left number column above is the bit in the 
parameter-mask field that corresponds to that parameter. 

The WRITE TIMEOUT at location $10 is used by the operating system 
to halt a Write command and by the magnetic tape driver to halt an 
Erase command. 

The READ TIMEOUT at location $14 is used by the operating system to 

halt any command other than a Write command. To get a more 

significant (smaller) timeout value for the Read, Space, Rewind, 

and Search commands for the magnetic tape driver, set the 

corresponding entries starting with TIMEOUT for TAPE READ to suit 
the system. 



FIELD 
STATUS/ERROR 



CHANNEL TYPE CODE 



DEFAULT FIELD 
VALUE DESCRIPTION 

Configuration-Status 

On return from a request, this field contains the 
current device status unless the status field in 
the user's lOCB is nonzero in which case the 
returned status/error field contains a code 
identifying the cause of the error. 

CONFIGURATION ERRORS 

lOSCEC Equate Code Device Status 

CECCDO $01 Specified parameter/ attribute 
invalid for Configure request; 
use Configure-Defaults request. 

CECVAD $02 Specified parameter/ attribute 
invalid for driver/channel type. 

CECDEN $41 Unknown density requested. 

Configuration -Status 

On return from a request, this field contains the 
code for the channel type. If an error is returned 
in the status/error field this field is reserved 
for future use. 



Code Type Channel 

$24 MVME435 magnetic tape adapter 
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FIELD 

DEVICE TYPE CODE 



DEFAULT FIELD 
VALUE DESCRIPTION 

Configuration-Status 

If status is returned in the status/error field, 

this field contains a code identifying the type of 

device. If an error is returned in the status/ 

error field, this field is reserved for future 
use. 



Code 



Device Type 
$05 Magnetic tape 



D 



DRIVER CODE 



Configuration -Status 

On return from a request, this field contains the 
code for this driver type. If an error is 
returned in the status/error field, this field is 
reserved for future use. 

Code Driver 

$07 Magnetic tape driver on I/O Channel 



ATTRIBUTES MASK 



PARAMETERS MASK 



ATTRIBUTES WORD 



VERSAdos SECTOR SIZE 
TOTAL NUMBER OF VERSAdos 



Configuration -Status 

A 1 in a particular bit position indicates that 

the corresponding bit of the attributes word field 

should be used to update the configuration. 

A indicates that the current attribute is 

retained. 

Configuration-Status 

A 1 in a bit position indicates that the driver 
recognizes the corresponding parameter. 
A indicates that the parameter is not recognized 
by the driver. 

Configuration -Status 

This field contains bit values that either 
determine or reflect the magnetic tape driver's 
behavior under specific circumstances. Paragraph 
3.5.10 describes the values and their 
correspondence with magnetic tape attributes. 

Not used by magnetic tape. 

Not used by magnetic tape. 
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FIELD 



DEFAULT 
VALUE 



FIELD 
DESCRIPTION 



WRITE TIMEOUT 



5000 
{5 seconds) 



B 



READ TIMEOUT 



360000 
(5 minutes) 



DENSITY REQUESTED 



NUMBER OF READ 
TRIES 

NUMBER OF WRITE 
TRIES 



NUMBER OF ERASURES 1 



TIMEOUT FOR TAPE 5000 
READ (5 seconds) 



TIMEOUT FOR SPACE 300000 
FORWARD OR (5 minutes) 
SPACE REVERSE 



Configuration -Status 

This field contains the number of milliseconds lOS 
should allow for Write request completion before 
halting the I/O. Attempting to change this field 
using the Configure-Device request results in an 
error. Use the Configure-Defaults request 
instead, followed by a Configure request with 
zeros in the parameters mask. 

Configuration-Status 

This field contains the number of milliseconds lOS 
should allow for completion of a Read or Output- 
with-Input request before halting the I/O. An 
attempt to change this field using the Configure- 
Device request results in an error. Use 
Configure-Defaults request instead, followed by a 
Configure-Device request with zeros in the 
parameters-mask field. 

Density for write from loadpoint. 

= 1600 bpi 

1 = 800 bpi 

Number of times the driver tries to read a block 
before error is sent (0 is equivalent to 1). 

Number of times the driver tries to write a block 



before trying to 
equivalent to 1). 



erase 



"4" of tape (0 is 



Number of times the driver erases the tape before 
reporting an error. 

This field contains the number of milliseconds the 
driver allows for completion of a tape read. This 
field can be changed with a Configure-Device 
request. 

This field contains the number of milliseconds the 
driver allows for completion of a Space-Forward or 
Space-Reverse command. A Configure-Device request 
can change this field. 
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DEFAULT FIELD 
FIELD VALUE DESCRIPTION 

TIMEOUT FOR 300000 This field contains the number of mill iseconds the 
REWIND (5 minutes) driver allows for completion of a Space-Forward or 

Space-Reverse command. Change field with 
Configure-Device request. 

TIMEOUT FOR 300000 This field contains the number of milliseconds the 
SEARCH FORWARD (5 minutes) driver allows for completion of a Search-Forward- 
OR REVERSE FOR FILEMARK For-Filemark or Search-Reverse-For-Filemark. A 

Configure-Device request can change this field. 



B 



3.5.10 Magnetic Tape Attributes Word Field 



ATTRIBUTE 


BIT 




15-2 


Density 
request 


1 



DEFAULT 
VALUE BIT DESCRIPTION 

Reserved 



1 = User requests a density for write from 
loadpoint. 

= User does not request a density for write 
from loadpoint. 

Reserved 



3.6 CONFIGURATION PARAMETER BLOCK EQUATES 

The following defines the symbols for the system equates (constants) that 
contain the offsets for the fields within the configuration parameter block. 
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FIELD 


TERMINAL 


EQUATE 
DISK PRINTER 






MAGNETIC TAPE 


ATTRIBUTES MASK 


lOSATM 


lOSATM 


lOSCTP 


lOSCTP 


CONFIGURATION ERROR CODE 


lOSCEC 


lOSCEC 


lOSCEC 


lOSCEC 


DATA BLOCK LENGTH 








lOSPLN 


lOSMLN 


DEVICE TYPE CODE 


lOSDTP 


lOSDTP 


lOSDTP 


lOSDTP 


DISCARD OUTPUT 


lOSDOP 











DENSITY REQUEST 











lOSDEN 


DRIVER CODE 


lOSDRC 


lOSDRC 


lOSDRC 





ECC DATA BURST LENGTH 





lOSECC 








END-OF-LINE STRING/CHARACTER 


lOSEOL 





lOSELC 





ERASURES 











lOSERT 


INTERLEAVE FACTOR 





lOSILV 








LINES PER PAGE 


lOSRSZ 





lOSRSZ 





LOGICAL LINE WIDTH 








lOSLRL 





NULL PADDING 


lOSNLS 











NUMBER HEADS 





lOSHDS 








NUMBER OF SECTORS TRACK-DRIVE 





lOSPTD 








NUMBER TRACKS 





lOSTRK 








MEDIA NUMBER TRACKS-DRIVE 





lOSTRKB 








MEDIA SECTOR SIZE 





lOSPSM 








PARAMETERS MASK 


lOSPRM 


lOSPRM 


lOSPRM 


lOSPRM 


PHYSICAL LINE WIDTH 


lOSREC 





lOSREC 





PRECOMPENSATION CYLINDER # 





lOSPCOM 








READ TERMINATORS 


lOSRTV 











REDUCED WRITE CURRENT 





lOSEWCC 








CYLINDER # 










READ TIMEOUT 


lOSRTO 


lOSRTO 





lOSRTO 


READ TRIES 











lOSRDT 


REPRINT LINE 


lOSRLN 











SECTOR SIZE 





lOSREC 








SECTORS/TRACK 





lOSSPT 








SPIRAL OFFSET 





lOSSOF 








STARTING HEAD NUMBER 





lOSSHD 








STATUS/ERROR 


lOSDST 


lOSDST 


lOSDST 


lOSDST 


STEPPING RATE 





lOSSRTD 








TERMINATOR-CLASS 


lOSTRC 











TOTAL SECTORS 





lOSRSZ 








WRITE TIMEOUT 


lOSWTO 


lOSWTO 


lOSWTO 


lOSWTO 


WRITE TRIES 











lOSWRT 


XOFF CHARACTER 


lOSXOF 











XON CHARACTER 


lOSXON 











TIMEOUT FOR TAPE READ 











lOSRDTO 


TIMEOUT FOR SPACE FORWARD 











lOSSPTO 


OR REVERSE 










TIMEOUT FOR REWIND 











lOSRWTO 


TIMEOUT FOR SEARCH FORWARD 











lOSSRTO 
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CHAPTER 4 
SUPPORTED DEVICES 



4.1 INTRODUCTION 

All input/output requests are made via directive Input/Output Services (IDS) 
calls. This chapter discusses the functional aspects of the devices and 
direct-access files supported by VERSAdos. Specific device-dependent 
information includes functions supported, status returned, and formatting 
performed. 

All devices and files support ASCII formatting, wait, I/O, and sequential 
access, unless otherwise noted in the individual driver or file handler 
description. The supported attributes listed with each description are in 
addition to those previously listed. 

A device code, a number between 20 and 254, defines all VERSAdos-supported 
devices. Additionally, device codes numbered between and 19 differentiate 
file types. 

4.2 CONTIGUOUS FILES 

The following paragraphs describe contiguous files. 

4.2.1 Devices Supporting Contiguous Files 

Contiguous files are supported on all devices supported by hard disk drivers 
and/or floppy disk drivers. The device code is 0. 

4.2.2 Supported Attributes 

Attributes of contiguous files are: 

Read 

Write 

Binary 

Wait 

Random 

Connection wait 

Image 

Block access 

Rewind 
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4.2.3 Functional Description 

Contiguous files may be randomly or sequentially accessed. These two access 
methods may be mixed without closing and reassigning the file. Reference to 
the current record pointer will access sectors. For sequential access, 
current record pointer value, as left by the previous operation, accesses the 
file. For random access, the user specifies the current record pointer to be 
used. When a contiguous file is assigned, the current record pointer is set 
to the beginning of the file unless write access with position at end is 
requested. Here, the current record pointer is positioned to the logical End- 
Of-File (EOF). 

Read: The formatted/image and record/block access options are ignored. 
All reads are image with block access. The requested data is 
directly read from the disk into the user-specified buffer. 
Reading starts at the specified RRN in the lOS call (random access) 
or can be determined by the current record pointer. For a Read- 
Current request, the current record pointer value is used. For a 
Read-PROPR request, the current record pointer minus one is used. 
For a Read-Next request, the sector to read is determined by 
current record pointer plus the number of sectors transferred on 
the previous request. On completion of the request, current record 
pointer is set to the first sector read. All reads begin on a 
sector boundary and end when the specified number of bytes have 
been transferred or the logical EOF is encountered. The buffer 
size specified must be a multiple of 256. 

Write: Same as Read except the data is transferred from the user specified 
buffer to the disk. The number of bytes transferred must be an 
integral multiple of 256. 

Rewind: The current record pointer is set to the beginning of the file so 
that the Read-Next request retrieves the first sector in the file. 

Status Definition: 

STATUS MEANING 

$00 Normal completion. 

$82 Invalid function. Sequential request for CURRENT on first request 
or request PRIOR when current record pointer is at beginning of 
file. Write request for file assigned for read access only, or Read 
request for file assigned for write access only. 

$84 Invalid data buffer address. Data buffer not multiple of 255 bytes. 

$87 Write-protected file. 

$C2 End-of-file. Attempted to read starting beyond the EOF or attempted 
write beyond the EOF. 

$E1-$ED Device-dependent error. 
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4.3 SEQUENTIAL FILES 

The following paragraphs describe sequential files. 

4.3.1 Devices Supporting Sequential Files 

Sequential files are supported on all devices supported by hard disk drivers 
and/or floppy disk drivers. The device code is 1. 

4.3.2 Supported Attributes 

Attributes of sequential files are: 

Read 

Write 

Update record 

Block and logical record access 

Binary 

Wait 

Random 

Connection wait 

Image 

Rewind 

Position 

4.3.3 Functional Description 

Sequential files may be randomly or sequentially accessed. In addition, block 
and record access is allowed and may be mixed without closing and reassigning 
the file. Referring to the current record pointer accesses records if doing 
record I/O, sectors if doing block I/O. For sequential access, current record 
pointer value as left by the previous operation accesses the file. For random 
access, the user specifies the current record pointer to be used. 

When a sequential file is first allocated, no data space exists. Therefore, 
it is necessary to write blocks or records sequentially before reading or 
writing randomly to the file. 

When a sequential file is assigned, the current record pointer is set to the 
beginning of the file unless position at end is requested. Here, the current 
record pointer is positioned to the EOF. 

The shared segment option is requested at assignment and must be selected if 
performing block writes or if block and record accesses are intermixed. This 
option causes FHS to allocate a memory segment whose size is determined by the 
file's data block size and grants shared access of this segment to the user. 
If the user selects this option, all block transfers must use this shared 
segment. 
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If the shared segment option is not selected and block reads are requested, 
the user must provide a data buffer large enough to accommodate the data block 
size. If only record I/O is requested, and no shared segment was allocated, a 
data block segment is allocated by FMS on the first I/O request. 

Read block: The requested data is directly read from disk into the 

user-specified buffer (must be the shared segment if 
one exists). One data block is transferred for each 
read request. Reading starts at the RRN (sector 
number) specified in the lOS call (random access). An 
"invalid random record number" error occurs if the RRN 
does not correspond to the first sector of a data 
block. Here, the data block is still transferred and 
the caller's lOS block is modified so that the logical 
sector number corresponding to the first sector in the 
data block is returned in the random record number 
field. Read-Next, Prior, and Current requests access 
the next, prior and current data block, respectively, 
based on the value of the current record pointer. 

Write block: The data buffer must be the shared segment allocated 

at assignment. The data is transferred directly from 
the shared segment to disk. Random and sequential 
features are identical to read block. An error occurs 
if a block Write follows record Write and does not 
reference the same data block that the record resided 
in. If a random Write is requested and the RRN 
specified does not correspond to the first sector of a 
data block, an error occurs and the transfer is not 
done. 

Read logical record: The data block containing the logical record specified 

by the RRN passed (random access) or determined by the 
current record pointer (sequential access) is read 
into a data block segment (unless it is already in 
memory). The requested number of bytes is moved from 
the data block to the user-specified buffer. The 
transfer ends when the entire record is transferred or 
the user's buffer is full. If the record is fixed 
length, the data is transferred as is to the user 
buffer. If the record is variable length and the 
formatted ASCII options are set on the I/O request and 
the file is not a spooler file, spaces are expanded as 
the record is transferred to the user buffer. 

The current record pointer is set to the record 
transferred. Read-Next, Prior, and Current record 
requests are supported. 
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Write logical record: 



Update record: 



Write record requests are only valid when being 
appended to the end of file; otherwise use Update. 
The data block containing the last record in the file 
is transferred into memory. After the last record, 
the record passed in the user buffer is transferred 
into the data block. For fixed length records, the 
record length determined by the user buffer start and 
end addresses must equal the record length. Fixed 
length records are moved as is to the data buffer. If 
the record is variable length, and the formatted ASCII 
options are set on the I/O request and the file is not 
a spooler file, spaces are compressed as the record is 
transferred to the data buffer. For spooler files, 
the transfer is always image and the options word for 
the lOS parameter block is inserted at the beginning 
of the record. The current record pointer is set to 
the record transferred. The only sequential Write 
request that could follow would be Next. For multiple 
write assignments, a Write-Next request always appends 
a record to the end of the file, regardless of where 
the last request left the current record pointer. 

The data block containing the logical record specified 
by the RRN passed (random access) or determined by the 
current record pointer (sequential access), is read 
into data block segment (unless it is already in 
memory). The length of the user record must be the 
same as the existing record. The record is transferred 
to the data block. Set the current record pointer to 
the record updated. To update a record, the file must 
be assigned EREW. 



Rewind: 
Position: 



Set the current record pointer to the beginning of the 
file. 

Set the current record pointer in the same way as an 
I/O request updating the current record pointer. 
Position to end of file is requested by doing a random 
logical record position with the RRN equal to -1. The 
current record pointer value is returned in the user's 
RRN field. Positioning to EOF returns the number of 
records in the file minus one. The requested record 
offset in the data block is returned in the user's 
length field; valid only if record I/O requested. 



Status Definition: 



STATUS MEANING 

$00 Normal completion. 

$0C Insufficient system space, 
record I/O. 



No room to allocate data buffer for 
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$82 Invalid function. Sequential request for Current on first I/O 
request or request Prior when current record pointer at beginning of 
file. Block Write for different data block than that accessed for 
record Write that preceded call. Intermixing block and record 
access without shared segment. Block Write was requested and shared 
segment does not exist. Delete-Record request. Random key request. 
Position request with block I/O. Update-Record request and file not 
assigned EREW access permission. 

$84 Invalid data buffer address. Data buffer length for fixed length 
records not equal to record length. Data buffer length for variable 
length record write larger than data block size. Data buffer 
addresses for record I/O conflict with address of shared segment 
(cannot use shared segment for record data). For Update-Record 
request, data buffer length not same size as existing record. If 
shared segment exists and block I/O requested, data buffer starting 
address not same as that specified at assignment, data buffer length 
not equal to data block size for block Read, or data buffer length 
larger than data block size for block Write. For block Write 
request, data buffer length not multiple of record length for fixed 
length record files or too short to accommodate all variable length 
records. For a Write/Update-Record request with space compression, 
user's record length greater than 256 bytes. 

$85 Invalid random record. On block I/O, RRN specified does not 
correspond to first sector in data block. 

$87 Write-protected file. Write or Update-Record selected for write- 
protected file. 

$C1 Buffer overflow. User data buffer for record Read request not large 
enough to accommodate entire record. For a Read request with space 
expansion, expanded record length greater than 256 bytes. 

$C2 End-of-File. Attempted to do Read or Update-Record starting beyond 
the end of the file or attempted Write starting beyond EOF plus one. 

$C8 FAB/data block conflict. With a shared segment, user destroyed some 
data in segment. 

$C9 Record does not exist. Update-Record request specified record that 
did not exist. 

$CA Record already exists. Write record request specified record that 
already existed. 

$CB Record overflow. With a shared segment, user destroyed some data in 
segment, causing a variable length of record to go beyond the end of 
the data block. 

SCO Insufficient disk space. No space available on volume for new FAB 
or data block. 
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4.4 INDEXED SEQUENTIAL FILES (NO DUPLICATE KEYS) 

The following paragraphs describe indexed sequential files (no duplicate 
keys). 

4.4.1 Devices Supporting Indexed Sequential Files Without Duplicate Keys 

Indexed sequential files are supported by hard disk drivers and/or floppy disk 
drivers. The device code is 2. 



4.4.2 Supported Attributes 

Indexed sequential files attributes are: 

Read 

Write 

Update record 

Delete record 

Block access 

Logical record access 

Random record access 

Read record with or without key 

Binary 

Wait 

Random 

Connection wait 

Image 

Rewind 

Position 

4.4.3 Functional Description 

Indexed sequential files support all the functions described for sequential 
files (refer to paragraph 4.3). The only difference is that the Update-Record 
function allows the new record to be a different length than the old record, 
as long as it is large enough to accommodate the key field. The key in the 
new record must be the same as the key in the old record. 

On a record Read request (either logical record or random key), the "return 
key with record" option is examined. If the option is not selected, the data 
returned to the user does not include the key. This makes it possible to have 
a zero data transfer length if the record contained only a key and no other 
data. If this option is selected, the entire record with key is returned to 
the user. 

For logical record writes, records must be appended to the end of the file. 
In addition, the key of the new record must be greater than the key of the 
current last record. 
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Additional functions supported: 

Read random key: The key of the record to be read is passed in the user's 
data buffer. If a record with the specified key exists, it 
is transferred to the user's buffer in the same way as 
logical record reads. If no record with the requested key 
exists, a "record does not exist" error is returned. 

Write random key: The record key to be written is passed in the user's data 
buffer, along with the rest of the record. If a record 
already exists with the key, a "record already exists" 
error is returned. Otherwise, the record is inserted in 
the file in ascending sequence by key, with spaces being 
compressed if the ASCII formatted options were selected for 
a variable length record. 

Delete record: The record key to be deleted is passed in the user's data 
buffer. If a record with the specified key exists, it is 
deleted from the file. 

Status Definition: Certain device-dependent errors return two sector numbers. 

STATUS MEANING 

$00 Normal completion. 

$0C Insufficient system space. No room to allocate data buffer for 
record I/O. 

$82 Invalid function. Sequential request for Current on first I/O 
request or after record Delete or request Prior when current record 
pointer at beginning of file. Block Write for different data block 
than that accessed for record Write that preceded call. Intermixing 
block and record access without shared segment. Block Write 
requested and shared segment does not exist. Position request for 
block I/O. 

$84 Invalid data buffer address. Data buffer length for fixed length 
records not equal to record length. Data buffer length for 
variable length record Write larger than data block size or smaller 
than key size (all requests). Data buffer addresses for record I/O 
conflict with address of shared segment. If shared segment exists 
and block I/O requested, data buffer starting address not same as 
that specified at assignment, data buffer length not equal to data 
block size for block Read, or data buffer length larger than data 
block Write. For block Write request, data buffer length not 
multiple of record length for fixed length record files or too 
short to accommodate all variable length records. For a 
Write/Update-Record request with space compression, user's record 
length greater than 256 bytes. 

$87 Write-protected file. Write, Update-Record or Delete-Record 
selected for write-protected file. 
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$C1 Buffer overflow. User data buffer for record Read request not 
large enough to accommodate entire record. For a Read request with 
space expansion, expanded record length greater than 256 bytes. 

$C2 End-of-File. Attempted to do Read or Update-Record starting beyond 
the end-of-file or attempted logical record Write or block Write 
starting beyond EOF plus one. 

$C8 FAB/data block conflict. With a shared segment, user destroyed 
some data in segment. 

$C9 Record does not exist. Update-Record or Delete-Record request or 
random key Read request specified record that did not exist. 

$CA Record already exists. Write record request specified record that 
already existed. 

$CB Record overflow. With a shared segment, user destroyed some data 
in segment, causing a variable length record to go beyond the end 
of the data block. 

$CC Key error, FAB/key conflict. With a shared segment, user destroyed 
some data in segment, causing keys to be out of sequence. 

$CD Insufficient disk space. No space available on volume for new FAB 
or data block. 



4.5 INDEXED SEQUENTIAL FILES (DUPLICATE KEYS ALLOWED) 

The following paragraphs describe indexed sequential files (duplicate keys 
allowed) . 

4.5.1 Devices Supporting Indexed Sequential Files With Duplicate Keys 

Indexed sequential files (duplicate keys allowed) are supported by hard disk 
drivers and/or floppy disk drivers. The device code is 1 for the hard disk 
driver and 2 for the floppy disk driver. 

4.5.2 Supported Attributes 

Same as for indexed sequential files (no duplicates). Refer to paragraph 
1.3.2. 



4.5.3 Functional Description 

Similar to description in paragraph 4.4.3. The main difference is that no 
error is given if it is a Write request and the key of the new record is the 
same as the key in an existing record. For random key access, if more than 
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one record exists with the same key, the first record is always accessed. The 
remaining records with the same key can be accessed by logical record access 
of Retrieve-Next. 

Logical record writes need not always append to the end of file. The 
exception is a request to Write-Prior or Write-Next such that the key of the 
new record is the same as the key of the current record. 

Status Definition: Refer to paragraph 4.4.3. 

4.6 INTERACTIVE TERMINAL 

The following paragraphs describe the attributes supported for an interactive 
terminal, and provide a function description. 

4.6.1 Supported Attributes 

Supported attributes for terminal devices are: 

Read 

Write 

Output with input 

Wait 

Proceed 

Connection wait 

Image 

Interactive 

Halt I/O 

Variable length records 

4.6.2 Functional Description (Teletype Configuration) 

Read image: Incoming characters are masked to 7 bits if 7 bits per 
character transmission was selected in the configuration. 

Data is read into the buffer until termination occurs. 
Normal termination can occur in one of three ways: 

a. The received character matches a READ TERMINATOR 
VALUE. 

b. The received character falls into the TERMINATOR 
CLASS. 

c. The buffer is full and the TERMINATE ON BUFFER FULL 
attribute is set. 

If the first or second method caused termination, the terminator character is 
placed in the buffer and is included in the LENGTH OF DATA TRANSFER. 
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The following characters have special interpretations when received: 



XOFF ) 

XON ) Refer to descriptions of these parameters in 

BREAK EQUIVALENT ) Chapter 3. 

DISCARD OUTPUT ) 

$00 NUL (discarded unless PASS NULS attribute is set) 



Read formatted: 



Similar to read image with the following exceptions: 

The terminator character (if there is one) is not 
included in the LENGTH OF DATA TRANSFER byte count, 
although it is still placed in the buffer. 



The special characters are: 



D 



XOFF 

XON 

BREAK EQUIVALENT 

DISCARD OUTPUT 

REPRINT LINE 

CANCEL LINE 

$00 

$08 

$01-$07, $09-$lF 

$7F 

$80-$FF 



Refer to descriptions of these parameters in 
Chapter 3. 



NUL (always discarded) 

BS (deletes last character entered) 

Other control characters ($01 echoes as A, etc.) 

DEL (like backspace) 

Invalid (character is discarded; bell is sounded) 



The terminator character is not echoed. Whenever normal termination occurs, 
the EOL string is echoed to the terminal. 



Write image: 
Write formatted: 



All characters in the buffer are sent to the terminal 



All characters in the buffer up to but not including 
the first $0D (CR) are sent to the terminal. If the 
number of characters written is not an exact multiple 
of the configured line length, the EOL string is sent. 



Output with input: 



Halt I/O: 



There are four varieties of output with input, 
resulting from the choice of formatted versus image 
modes for the output and for the input. A Write 
operation followed by a Read operation is performed. 
The LENGTH OF DATA TRANSFER byte count reflects the 
input, rather than the output. 



Abnormally terminates 
outstanding. 



any of the above requests 
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Configure-Device 
Configure-Defaults 
Configuration -Status 

Status Definition: 



NOTE 

A Halt-I/0 command, a break received during I/O, 
a parity error, a framing error, or an overrun 
condition will abnormally terminate any I/O and 
cause a partial reset of the port. 

) 

) These commands are described in detail in Chapter 3. 

) 
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STATUS MEANING 

$00 Normal completion 

$82 Invalid function 

$84 Invalid data buffer address 

$C1 Buffer overflow (read only) 

$C6 Break condition 

$D1-$EF Device-dependent error 



4.7 LINE PRINTER 

The following paragraphs define the supported line printers and describe the 
supported line printer attributes. 



4.7.1 Supported Devices 

The device codes are returned in the high-order byte of the FHS parameter 
block options field for a Retrieve-Attributes call. Refer to paragraph 2.3.8. 



DEVICE 
Low speed (60-200 1pm) line printer 
High speed (600 1pm) line printer 
Low speed (50-200 1pm) line printer 



DEVICE CODE 
90 
91 
95 



NOTE 

These codes are returned on an FHS Retrieve- 
Attributes call and are shown only for back- 
ward compatibility. The Configuration-Status 
request should be used to retrieve a device 
code from the current configuration values. 
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4.7.2 Supported Options 

Wait 

Proceed 

Connection wait 

Formatted 

Image 

Variable length records are supported. 

4.7.3 Functional Description 

The Halt-I/0 command function and the Write, Configure-Device, Configure- 
Defaults, and Configuration-Status data transfer requests are supported. 

Write formatted: The user buffer is output until a CR is found, the buffer is 
empty, or the logical record width is reached with the 
Wraparound/Truncate attribute set. Driver operation is 
affected by various configuration parameters and attributes. 
Refer to Chapter 3. 

Write image: Data is transmitted exactly as found in the user's buffer. 
The system does not ensure that the data is printed later or 
that the paper is properly moved. The user should be 
familiar with the characteristics of the device being used. 
Except for the WRITE TIMEOUT and FORMFEED AFTER ASSIGN 
attributes, all configuration parameters and attributes are 
ignored in this mode. 

Halt-I/0: Any outstanding Write requests are terminated. 

Configure-Device 

Configure-Defaults 

Configuration-Status: These requests are described in Chapter 3. 

Status Definition: 

STATUS MEANING 

$00 Normal completion 

$82 Invalid function 

$84 Invalid data buffer address 

$D1-$EF Device-dependent error 
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4.8 HARD DISK 

The supported hard disk devices, their supported attributes, and a functional 
description are provided in the following paragraphs. 

4.8.1 Supported Devices 
Devices configured on: 

Universal Disk Controller (UDC) 

Winchester controller board (RWINl) 

MVME420 interface board 

using an SA1403 or DTC520A controller boards 

MVME315 disk controller board 

MVME320 disk controller board 

VM22 disk controller 

4.8.2 Supported Attributes 

Supported for hard disks are: 

Read 

Write 

Block access 

Binary 

Wait 

Proceed 

Random 

Connection wait 

Retry 

Alternate track 

Image 

Image attributes are supported; sequential access and formatted are not 
supported. 
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4.8.3 Functional Description 

Read: The data is read from the disk starting at the sector specified by 
the RRN passed until the buffer is full or until the end of the disk 
is reached. If the RRN specifies a sector beyond the end of the 
disk, an error is returned. 

Write: Data is written from the buffer to the disk, starting at the sector 
specified in the RRN field until the buffer is empty. If an attempt is made 
to write beyond the end of disk, an error is returned. Here, no data is 
transferred. 

Format: Formats the disk or track containing the PSN. If the format 
alternate track option is set, the PSN is mapped to an alternate 
track. 

Errors on data transfers cause the operation to be retried before returning an 
error status unless directed not to retry. 

All data transfers start and end on a sector boundary. Each sector is 255 
bytes. 

Status Definition: Certain device-dependent errors return a sector number. 

STATUS MEANING 

$00 Normal completion. 

$82 Invalid function. Sequential access requested. Format of file 
requested or volume/device not assigned EREW. 

$84 Invalid data buffer address. Data buffer not multiple of 256 bytes. 

$85 Invalid random record. Request starts beyond end of disk. 

$88 Invalid disk format. 

$C3 End of volume. Write request goes beyond end of disk. No data is 
transferred. Read request starts before end of disk but request is 
to transfer data beyond the end of disk. The data length returned 
indicates the actual number of bytes transferred. 

$D1-$EF Device-dependent error. 

$F1-$F9 Channel -dependent error. 
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4.9 FLOPPY DISK 

The supported floppy disk devices, their supported attributes, and a 
functional description are provided in the following paragraphs. 

4.9.1 Supported Devices 

Devices configured on: 

Floppy Disk Controller (FDC) 

Universal Disk Controller (UDC) 

Winchester controller board (RWINl) 

MVME420 interface board 

using an SA1403 or DTC520A controller boards 

MVME315 controller board 

MVME320 controller board 

VM22 disk controller 

4.9.2 Supported Attributes 

The floppy disk supports -the same attributes as the hard disk. Refer to 
paragraph 4.8.2 for a complete description. 

4.9.3 Functional Description 

The floppy disk functions are similar to those of the hard disk. Reference 
paragraph 4.8.3 for a description of the floppy disk Read, Write, and Format 
functions. 

4.10 MAGNETIC TAPE 

The supported magnetic tape attributes and a functional description are 
provided in the following paragraphs. 

4.10.1 Supported Attributes 

Read 

Write 

Binary 

Image 

Halt I/O 

Filemark 
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4.10.2 Functional Description 

Read: A block of data {no limit on length) is read from the tape to a 

memory buffer designated by the user. If the block contains more 

bytes than can fit in the user buffer, the buffer overflow message is 
returned. 

Write: A block of data of any length is written to the tape. 

Configure-and-Mount Command 

Parameter block (lOCB): 

lOSBLK: 



DC.B 


$01 


Request code 


DC.B 


$80 


Function specification 


DC.W 


$0000 


Options field 


DC.B 


$00 


Status 


DC.B 


LUN 


Logical unit 


DC.W 





Reserved 


DC.L 


CSB 


CSB address 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 



D 



The Configure-and-Mount command records the configuration requested by the 
user in the CSB. If the requested configuration is legal, the tape is 
rewound, if necessary, to bring the tape to loadpoint, and the first block on 
the tape is read in an attempt to determine: 

a. Tape density 

b. Whether the transport density can be controlled by the software 

If the transport density is not software selectable, but must be selected by 
pushing a button on the front panel of the transport, and if the user has 
selected the transport density 800 bpi, then tape density as recorded in the 
status word may not be accurate. 

If a previous Configure-and-Mount command has succeeded (which can happen if 
there is a tape on the transport when the system is booted), then succeeding 
Configure-and-Mount commands are rejected until a Configure-and-Dismount 
command has been received. 
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Configure-Only 


Command 




Parameter block 


. (lOCB): 




lOSBLK: DC.B 


$01 


Request code 


DC.B 


$80 


Function specification 


DC.W 


$0001 


Options field 


DC.B 


$00 


Status 


DC.B 


LUN 


Logical unit 


DC.W 





Reserved 


DC.L 


CSB 


CSB address 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 



The Configure-Only command records the configuration requested by the user in 
the CSB. The tape does not move. If the requested configuration is legal, it 
takes effect when the next command is sent to the tape drive. (Figure 3-7 
describes the CSB block.) 

After a tape has received a Configure-and-Mount command, any number of 
Configure-Only commands are accepted. The Configure-Only command is used to 
change any of the following attributes or parameters. The Configure-and-Mount 
command may also be used to change these attributes and parameters. 

a. Requesting a certain density for write from loadpoint. 

To request 1500 bpi density, for example, set bit 1 of the attributes 
mask and the attributes word, set bit 4 of the parameter mask, and put 
into the DENSITY REQUESTED field of the CSB (offset $18). 

ATTRIBUTES MASK $02 

PARAMETERS MASK $10 

ATTRIBUTES WORD $02 

DENSITY REQUESTED 

To request 800 bpi density, set bit 1 of the attributes mask and the 
attributes word, set bit 4 of the parameter mask, and put 1 into the 
DENSITY REQUESTED field of the CSB (offset $18). 

ATTRIBUTES MASK $02 

PARAMETERS MASK $10 

ATTRIBUTES WORD $02 

DENSITY REQUESTED 1 
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b. Changing the number of read tries before an error message is sent 
back. 

To change the number of read tries to 6, for example, set bit 5 of the 
parameters mask and put 6 into the NUMBER OF READ TRIES field of the 
CSB (offset $19). 

ATTRIBUTES MASK $00 
PARAMETERS MASK $20 
NUMBER OF READ TRIES 6 

Putting a into the number of read tries defaults to 1 read try. 

c. Changing the number of write tries before an erasure of the tape is 
done. 

To change the number of write tries to 2, for example, set bit 6 of 
the parameters mask and put 2 into the NUMBER OF WRITE TRIES field of 
the CSB (offset $1A). 

ATTRIBUTES MASK $00 
PARAMETERS MASK $40 
NUMBER OF WRITE TRIES 2 

Putting a into the number of write tries defaults to 1 write try. 

d. Changing the number of erasures after write tries before an error 
message is returned. 

To change the number of erasures to 4, for example, set bit 7 of the 
parameters mask and put 4 into the NUMBER OF ERASURES field of the CSB 
(offset $1B). 

ATTRIBUTES MASK $00 
PARAMETERS MASK $80 
NUMBER OF ERASURES 4 

Configure-and-Dismount Command 

Parameter block (lOCB): 

lOSBLK: 



D 



DC.B 


$01 


Request code 


DC.B 


$80 


Function specification 


DC.W 


$1000 


Options field 


DC.B 


$00 


Status 


DC.B 


LUN 


Logical unit 


DC.W 





Reserved 


DC.L 


CSB 


CSB address 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 
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The Configure-and-Dismount command dismounts the tape: 

a. No Read, Write, or other command will be accepted for the tape drive, 
except Configure and Status commands. 

b. When the current assignment to the tape drive is dissolved, the 
configuration reverts to default configuration. 

It is recommended to issue a Dismount command when a tape is removed from the 
transport, followed by a Configure-and-Mount command when a new tape is placed 
on the transport, to determine the density of the new tape. 

Configure-Defaults Command 

Parameter block (lOCB): 

lOSBLK 



DC.B 


$80 


Request code 


DC.B 


$02 


Function specification 


DC.W 


$0000 


Options field 


DC.B 


$00 


Status 


DC.B 


LUN 


Logical unit 


DC.W 





Reserved 


DC.L 


CSB 


CSB address 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 



The Configure-Defaults command changes the default values for any of the 
configuration attributes or parameters. The only way to change WRITE TIMEOUT 
or READ TIMEOUT is to use the Configure-Defaults command. 

To change the WRITE TIMEOUT to 1000 milliseconds (one second), for example, 
set bit 2 of the parameters mask and put 1000 in the WRITE TIMEOUT field of 
the CSB (offset $10). 

ATTRIBUTES MASK $00 
PARAMETERS MASK $04 
WRITE TIMEOUT 1000 
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Configuration-Status Command 
Parameter block (lOCB) 



lOSBLK: 



DC.B 


$01 


Request code 


DC.B 


$40 


Function specification 


DC.W 


$0000 


Options field 


DC.B 


$00 


Status 


DC.B 


LUN 


Logical unit 


DC.W 





Reserved 


DC.L 


CSB 


CSB address 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 


DC.L 





Reserved 



The Configuration-Status command returns the status and current configuration 
of the tape drive. 
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STATUS byte: 



+ +- 



Bits 2, 1, and 
Tape density 

= 1600 bpi 

1 = 800 bpi or blank 

= Density not 

selectable 
in software 

1 = Density selectable 

in software 

= Tape is not 

write-protected 

1 = Tape is 

write-protected 

= Tape drive ready 

(see NOTE) 

1 = Tape drive not ready 



NOTE: This bit is set if the initial Configure-and-Mount command from lOS 
fails because of a bad parameter or attribute. It is also set when 
a Configure-and-Dismount command with all valid parameters and 
attributes is received. 
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Write-Filemark: 

Erase: 

Space-Forward: 



A filemark is written to the tape. 

Four inches of tape is erased. 

A block of data is spaced over on the tape. If the block was 
a filemark, the end-of-file message is returned. 



Space-Reverse: Similar to Space-Forward, but in the reverse direction. 



D 



Search-Filemark 
Forward: 



Search-Filemark 
Reverse: 



Rewind: 



Halt-I/0: 



The tape is advanced until a filemark is detected, the end of 
tape is reached, or the transport has found a length of blank 
tape and has timed out. A normal completion message is 
returned if a filemark is detected. 



Similar to Search-Filemark-Forward, but in reverse direction. 

The tape is rewound to loadpoint. If successful, a normal 
completion message (00) is returned. 

Terminates any of the above requests. 



SUMMARY OF COMMANDS FOR MAGNETIC TAPE 



Code 

Function 

Options 



CODE COMMANDS 

READ WRITE 

$00 $00 
$01 $02 
for Configure command 



CODE 1 COMMANDS 
REWIND CONFIGURE 



$01 
$02 



STATUS HALT I/O 



$01 $01 $01 
$80 $40 $10 
$0000 (mount) 
$0001 (configure only) 
$1000 (dismount) 



CODE 40 COMMANDS 



Code 
Function 



ERASE 



$40 
$02 



WRITE 
FILEMARK 



$40 
$04 



SEARCH 
FORWARD 
FOR FILEMARK 

$40 
$06 



SEARCH SPACE 
REVERSE FORWARD 
FOR FILEMARK 



$40 

$07 



$40 
$08 



SPACE 
REVERSE 



$40 
$09 
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4.10.3 Error Messages 

$00 Normal completion, no errors. 
82 Invalid function. 
88 Configuration error. 



CI Buffer overflow. 
Read: 

02 End-of-file. 

C3 End of volume. 
Read: 
Write: 

D4 Device not mounted 
D5 Beginning of volume 

D7 Tape already mounted. 

El Device not ready. 

E3 Error on Read or Write. 

READ: 

WRITE: 



User buffer too small. 

Filemark detected on Read or Space-Forward or 
Space-Reverse. 

End of tape detected. 

Data past end of tape is inaccessible. 

Some data may be written. It is best to Space- 
Reverse and Write the block to another tape. 
Check the length field in parameter block to see 
how many bytes were actually transferred. 

No Configure-and-Mount has been successful since 
last Dismount command. 

Beginning of tape (loadpoint) detected. Tape was 
at loadpoint when a reverse type command was 
received (except Rewind), or loadpoint was 
detected at the completion of the command. 

To change configuration on tape that is already 
mounted, do a Configure-Only command. 



It is best to Space-Reverse. 

Block may be shorter than expected. Try Space- 
Reverse and erasing. 



On Read or Write, check length of data transfer to see if any bytes were 
transferred. Some bytes may be transferred if there was an error 
condition and the tape drive became not ready during an attempt to reread 
or rewrite the data. 
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E4 Write-protect. 

E6 Timeout from Halt-I/0 or on Read if transport stops after reading a 
length of blank tape. Timeout from driver based on timeout configuration 
parameters (refer to Magnetic Tape Configuration Parameter Block). 

F3 Channel down. An operation complete interrupt was received but 

no operation was pending. Something may be wrong 
with the controller. The F3 message is sent just 
once per abnormal interrupt received. 
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5.1 GENERAL DESCRIPTION 



CHAPTER 5 
PROGRAM LOADER 



5.1.1 Function 

The program loader is a TRAP #4 server function and is used to: 

a. Create a new task. 

b. Allocate memory segments for the task based on segment information 
found in the Loader Information Block (LIB) of a load file created by 
the linkage editor. The loader forces segments of position 
independent tasks to be loaded on logical addresses that are multiples 
of 64Kb. 

WARNING 

PROGRAMS THAT ARE NOT POSITION-INDEPENDENT BUT ARE 
LINKED USING ATTRIBUTE P WILL NOT EXECUTE PROPERLY. 



B 



c. Read the contents of each segment from the load file into the segments 
allocated. 



5.1.2 Calling Sequence 

The task created by the loader is in a DORMANT state following a successful 
completion of that load function. 



The calling sequence is: 



MOVE.L 


#1,D0 


LEA 


LOADPB,AO 


TRAP 


#4 



Directive number 1 for the loader. 
Parameter block address in AC. 
Call the TRAP #4 Server. 



5.1.3 Loader Parameter Block 

The loader parameter block consists of three parts: 

a. A parameter block used with the Create Task Control Block (CRTCB) 
directive. 

b. Loader options and command line information. 
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c. An FHS parameter block that defines the load module file containing 
the contents of the task to be loaded. This part may be omitted if 
the calling task has assigned the load file and has passed the logical 
unit number of that file to the loader as part of the loader options. 

Table 5-1 describes the first two parts. The third part is described in 
Appendix A. 



TABLE 5-1. Parameter Block 
CONTENT 



OFFSET BYTES 



B 



$00 4 Taskname (4-byte ASCII name) 

$04 4 Session number 

$08 2 CRTCB (Create TCB) options 

Bit 15=1 The new task's monitor is specified in the 
monitor fields that follow. 

Bit 14=1 The new task's monitor is the same as the 
calling task's monitor. 

Monitor taskname 
Monitor session number 

Initial priority If 0, this field is set equal to the 
calling task's current priority. 

Limit priority If 0, this field is set equal to the 

calling task's limit priority. 

Task attributes 



$0A 
$0E 
$12 


4 
4 

1 


$13 


1 


$14 


2 



Bit 15=1 New task is a system task (this bit is ignored 
if calling task is a user task). 

Bit 13=1 Crash system if new task terminates abnormally 
(this bit is ignored if new task is a user 
task) . 

Bit 12=1 Dump the contents of memory to a disk file if 
task terminates abnormally. 

$16 4 Task entry address 

$1A 2 Task user I.D. If caller is user task, this field is 

set equal to caller's user I.D. 

$1C 2 Load options 

Bit 15=1 Calling task proceeds while new task is 
loaded. 
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TABLE 5-1. Parameter Block (cont'd) 
CONTENT 



OFFSET BYTES 



Bit 15=0 Calling task waits until the load is complete. 

Bit 14=1 Loader must assign load file; caller provides 
an FHS parameter block. 

Bit 14=0 Caller has assigned load file; a logical unit 

number is provided. 
Bit 13=1 A command line, to be passed to the new task, 

is provided by the caller at the address 

given. 

Bit 13=0 No command line is provided by caller. 

Bits 7-0 Each of these option bits refers to a specific 
field in the CRTCB portion of the parameter 
block. If the bit=l, the value supplied in 
the parameter block is used by the loader. If 
the bit=0, the loader uses the value found in 
the LIB of the load file. 
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Bit 7 


Logical entry address 


Bit 6 


Task attributes 


Bit 5 


Task limit priority 


Bit 4 


Task initial priority 


Bit 3 


Monitor taskname and session number 


Bit 2 


CRTCB options 


Bit 1 


Task session 


Bit 


Taskname 



$1E 


1 


Command line 
options = 1) 


length, in bytes (if bit 13 of loader 


$1F 


1 


Logical unit 
options = 0) 


number of load file (if bit 14 of loader 


$20 


8 


Reserved 




$28 


4 


Command line < 


iddress (if bit 13 of loader options = 1) 


$2C 


34 


An FHS parameter block with all the file descriptor 
fields filled in by the caller. Required field if bit 14 
of loader options = 1. Refer to Appendix A. 
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5.2 OPERATION 



5.2.1 Loading a User Task 



B 



Any task in the system can load a user task. If the task that calls the 
loader is also a user task, then the session number and user ID of the new 
task is always set equal to the calling task's session number and user ID. If 
the calling task is a system task, it can provide a new session number and 
user ID. 



5.2.2 Loading a System Task 

A system task is a privileged task and can only be loaded if another system 
task calls the loader. The new task is loaded as a system task if either set 
of conditions is met: 



a. Bit 6 of the loader options = I (use task attributes supplied) and bit 
IS of task attributes = I. 

b. Bit 6 of the loader options = 0, bit 15 of the task attributes found 
in the LIB of the load file = 1, and the user ID supplied by the 
caller = 0. If these conditions are met, the new task's session 
number and priority is also be taken from the LIB of the load file. 

To generate a system task it must be linked, with attributes set, to the 
system. It can only be started by user or by another system task. 

5.2.3 Return Parameters 

When the load is completed, the entire loader parameter block is moved back to 
the caller's address space with all fields filled in with the values used in 
the load process. This provides the caller with the information needed to 
identify and communicate with the new task. 

DO = Successful load. 

DO = 180000XX An error status was returned as a result of a call to FHS. 

DO = lOOOOOXX An error status was returned as a result of a call to IDS. 

DO = 20000001 An undefined directive number was provided in DO on entry. 

DO = 20000012 Load segment logical address not within segment boundaries. 

DO = 20000013 File referenced is not a load file. 
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RETRIEVE 
ATTRIBUTES 


FETCH 

DIRECTORY 

ENTRY 


FETCH 
DEFAULT 
VOLUME 


PARAMETER 


# OF 
BYTES, 


REG RTN 


REO RTN 


REO RTN 


COMMAND 




$80 




$40 


$8 


OPTIONS 






A 




A 


STATUS 






A 


A 


A 


LUN 




A 




A 




VOLUME ID 






A 




A 


USER NUMBER 


2 




C 


C 




CATALOG 


8 




C 


C 




FILENAME 


8 




C 


C 




EXTENSION 


2 




C 


C 




RESERVED 


2 


$0 




$0 


$0 


WRITE CODE 


1 




A 






READ CODE 


1 




A 






RECORD LENGTH 


2 




A 






SIZE/POINTER 


4 




A 


P P 




REQUIRED FIELD: 













A = ALWAYS REQUIRED 

C = CONDITIONALLY REQUIRED 

P = ALWAYS REQUIRED - POINTER TO CALLER'S ADDRESS SPACE 

RETURNED FIELD: 

A = ALWAYS RETURNED 

C = CONDITIONALLY RETURNED 

P = DATA RETURNED AT LOCATION POINTED TO IN CALLER'S ADDRESS SPACE 
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CODE 1 COMMANDS - UTILITY COMMANDS 
REDEFINED PARAMETER BLOCKS 



APPENDIX A 







FETCH DEVICE 
MNEMONICS 






CHANGE LUN 
ASSIGNMENT 


PARAMETER 


# OF 
BYTES 


REO RTN 


PARAMETER 


# OF 
BYTES 


REO RTN 


COMMAND 


1 


$20 


COMMAND 


I 


$10 


OPTIONS 


2 


A 


OPTIONS 


2 


A 


STATUS 


1 


A 


STATUS 




A 


LUN 


1 




LUA 




A 


POINTER 


4 


P P 


LUB 




A 


LENGTH 


4 


A A 


RESERVED 




$0 








TASKNAME 




A 








TASK SESSION 




A 



REQUIRED FIELD: 

A = ALWAYS REQUIRED 

P = ALWAYS REQUIRED - POINTER TO CALLER'S ADDRESS SPACE 



RETURNED FIELD: 

A = ALWAYS RETURNED 

P = DATA RETURNED IN CALLER'S ADDRESS SPACE 
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CANCEL CONTINUE FORMS 



PRINT COPIES 



QUEUE 



PARAMETER 


# OF 
BYTES 


RE 


COMMAND 




$8 


OPTIONS 






STATUS 






LUN 






VOLUME ID 




C 


USER NUMBER 


2 


A 


CATALOG 


8 


C 


FILENAME 


8 


C 


EXTENSION 


2 


C 


RESERVED 


2 




RESERVED 


4 




JOB ID 


4 


C 


DEVICE NAME 


4 




FORMS ID 


4 




REQUIRED 


FIELD: 





REQ EIN REfl EIN REQ RIN REQ RIN REQ BIN REQ RTN 
$40 $20 $10 $8 $4 

AAA 
A A A A A A 



A = ALWAYS REQUIRED 

C = CONDITIONALLY REQUIRED 

F = ALWAYS REQUIRED - REDEFINED AS FORMS ID 

U = ALWAYS REQUIRED - REDEFINED AS USER'S CONSOLE NAME 



RETURNED FIELD: 

A = ALWAYS RETURNED 
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CODE 1 COMMAND FUNCTIONS 



PARAMETER 


# OF 
BYTES 


POSITION 
REO RTN 


REWIND 
REO RTN 


LOCAL 

BREAK 

CLAIMER 

REO RTN 


CODE 


1 


$01 




$01 


$01 


FUNCTION 


1 


$01 




$02 


$20 


OPTIONS 


2 


A 




A 


C 


STATUS 


1 




A 


A 


A 


LUN 


I 


A 




A 


A 


RESERVED 


2 


$0 




$0 


$0 


RANDOM RECORD 
NUMBER 


4 


A 


A 


A 




BUFFER START 
ADDRESS 


4 










BUFFER END 
ADDRESS 


4 










LENGTH OF 
DATA TRANSFER 


4 










COMPLETION 
SERVICE ADDRESS 


4 








C 



Q 



REQUIRED FIELD: 

A = ALWAYS REQUIRED 

C = CONDITIONALLY REQUIRED 



RETURNED FIELD: 

A = ALWAYS RETURNED 

C = CONDITIONALLY RETURNED 



157 



MICROSYSTEMS 



® 



MOTOROLA 



APPENDIX B 



lOS PARAMETER BLOCKS TRAP #2 



II 



CODE 1 COMMAND FUNCTIONS 



PARAMETER 


# OF 
BYTES 


TEST I/O 
COMPLETE 

REQ RTN 


WAIT ONLY 
REQ RTN 


HALT I/O 
REQ RTN 


CODE 


1 


$01 


$01 


$01 


FUNCTION 


1 


$04 


$08 


$10 


OPTIONS 


2 








STATUS 


1 


Z 


C 


B 


LUN 


1 


A 


A 


A 


RESERVED 


2 


$0 


$0 


$0 



REQUIRED FIELD: 

A = ALWAYS REQUIRED 



RETURNED FIELD: 

B = STATUS RETURNED IN BOTH I/O 
PARAMETER BLOCKS 

A = ALWAYS RETURNED 

Z = Z BIT ALWAYS RETURNED 

1 = NO I/O = I/O EXISTS 

C = ALWAYS RETURNED TO ORIGINAL 
I/O PROCEED PARAMETER BLOCK 
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D 



PARAMETER 


# OF 
BYTES 


CONFIGURATION-STATUS 
REQUEST 

REQ RTN 


CONFIGURE-DEVICE 
REQUEST 

REO RTN 


CODE 


I 


$01 


$01 


FUNCTION 


1 


$40 


$80 


OPTIONS 


2 






STATUS 


1 


AZ 


AZ 


LUN 


1 


A 


A 


RESERVED 


2 


$00 


$00 



REQUIRED FIELD: 
A = ALWAYS REQUIRED 



RETURNED FIELD: 
A = ALWAYS RETURNED 
Z = Z BIT ALWAYS RETURNED 

= REQUEST ACCEPTED/SUCCESSFUL 

1 = REQUEST REJECTED/UNSUCCESSFUL 
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CODE 2 COMMAND FUNCTIONS 



PARAMETER 


# OF 
BYTES 


NEGATE LOCAL 
BREAK CLAIMER 

REO RTN 


CODE 


1 


$02 


FUNCTION 


1 


$01 


OPTIONS 


2 




STATUS 


1 


A,Z 


LUN 


1 


A 


RESERVED 


2 


$00 



REQUIRED FIELD: 

A = ALWAYS REQUIRED 



RETURNED FIELD: 
A = ALWAYS RETURNED 
Z = Z BIT ALWAYS RETURNED 

= REQUEST ACCEPTED/SUCCESSFUL 

1 = REQUEST REJECTED/UNSUCCESSFUL 
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CODE 2 COMMAND FUNCTIONS 



D 







CLAIM DRIVER 
EVENTS 


PARAMETER 


# OF 
BYTES 


REQ RTN 


CODE 


1 


$02 


FUNCTION 


1 


$02 


OPTIONS 


2 




STATUS 


1 


A,Z 


LUN 


1 


A 


RESERVED 


2 





REQUIRED FIELD: 
A = ALWAYS REQUIRED 



RETURNED FIELD: 
A = ALWAYS RETURNED 
Z = Z BIT ALWAYS RETURNED 

= REQUEST ACCEPTED/SUCCESSFUL 

1 = REQUEST REJECTED/UNSUCCESSFUL 
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El 



CODE 2 COMMAND FUNCTIONS 







NEGATE DRIVER 
EVENTS 


PARAMETER 


# OF 
BYTES 


REO RTN 


CODE 


1 


$02 


FUNCTION 


1 


$04 


OPTIONS 


2 




STATUS 


1 


A,Z 


LUN 


1 


A 


RESERVED 


2 





REQUIRED FIELD: 
A = ALWAYS REQUIRED 



RETURNED FIELD: 
A = ALWAYS RETURNED 
Z = Z BIT ALWAYS RETURNED 

= REQUEST ACCEPTED/SUCCESSFUL 

1 = REQUEST REJECTED/UNSUCCESSFUL 
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CODE 80 COMMAND FUNCTIONS 







CONFIGURE DEFAULTS 
REQUEST 


PARAMETER 


BYTES 


# 
REQ 


OF 
RTN 


CODE 


1 


$80 




FUNCTION 


1 


$02 




OPTIONS 


2 






STATUS 


1 




AZ 


LUN 


1 


A 




RESERVED 


2 


$00 





B 



REQUIRED FIELD: 
A = ALWAYS REQUIRED 



RETURNED FIELD: 

A = ALWAYS RETURNED 

Z = Z BIT ALWAYS RETURNED 

= REQUEST ACCEPTED/SUCCESSFUL 

1 = REQUEST REJECTED/UNSUCCESSFUL 
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El 



CODE $80 COMMAND FUNCTION 



PARAMETER 


# OF 
BYTES 


UNCLAIMED 
BREAKS 
(SYSTEM FUNCTIONS) 

REO RTN 


CODE 


1 


$80 


FUNCTION 


1 


$01 


OPTIONS 


2 




STATUS 


1 


A 


LUN 


1 




RESERVED 


2 


$0 



RETURNED FIELD: 

A = ALWAYS RETURNED 
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LOADER PARAMETER BLOCKS 

(TRAP #4) 
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LOADER PARAMETER BLOCKS TRAP #4 



00 

A0 



LOADER = 1 



PAR BLOCK ADR 



a 



PAR i BLO 


CK +0 

+4 

+8 

+A 

+E 

+ 12 

+13 

+14 

+16 

+1A 


TASK NAME 




SESSION NUMBER 


CO 1 


CREATE TCB DIRECTIVE OPTIONS 




I— LU 


MONITOR TASK NAME 


LU LlJ CJ 

1— s: o 
<a: <a: _i 


MONITOR TASK SESSION 


LLJ Q: CD 
Diet 


INITIAL PRIORITY 










LIMIT PRIORITY 






CREATE TCB TASK ATTRIBUTES 






TASK ENTRY POINT 


V 


TASK USER I. D. 






A 


+1C 
+1E 
+1F 
+20 
+24 
+28 


LOADER OPTIONS 






CMD LINE LEN 






q: I— 
lli to _r 


REQUESTOR'S LUN 




Q LLl 2 

<: =>fc 
ocrg 


RESERVED 


_JUJ "=■ 


RESERVED 


V 


REQUESTOR CMD LINE BUFFER ADDRESS 


A 


+2C 
+2D 
+2E 
+30 
+31 
+32 
+36 
+38 

+40 

+48 
+4A 
+4C 
+4D 






t 

PARAMETERS 

SUPPLIED BY 
LOADER 
1 






























1 o 

1 LU 


VOLUME NAME 


^ 1§ 


USER NUMBER 




PART 

BLOCK 

BE L 


CATALOG NAME 




- 


UIRED 
PARAM 
FILE T 


FILE NAME 




- 


croo 

Lij :r z 

q: U- LlJ 


EXTENSION 






1 o 


RESERVED 




1 o 

1 1— 


W - CODE 








R - CODE 
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access mode 
access permission 

access protection code 
ACIA Debug port 
Allocate function 

allocation (general) 
ASCII 

ASCII formatted options 

ASQ 

Assign function 

assigned logical connection 

assignment error 

asynchronous communications line 

Asynchronous Service Queue (ASQ) 

attention event 

attributes 

attributes mask 

attributes word 



auto-LF 

backslash 

baud rate 

baud rate code 

binary job number 

binary load module 

binary user number 

bit map 

break condition 

break equivalent 

buffer 



buffer overflow 

buffer space 
buffer-end 
buffer-start 
buffered file 
bus 



13 

3, 4, 14, 15, 17, 20, 21, 27, 33-39, 

43, 45, 126 

13-15, 17, 29, 33, 34, 36-38 

76-77 

3, 20, 21, 26-29, 31, 32, 34, 35, 39, 

40, 123, 125, 128, 145 
16, 29, 30, 33, 35, 58 

5, 10, 27, 28, 46, 47, 56, 64, 86, 89, 

121, 124, 125, 128, 146 

89, 124, 125, 128 

See Asynchronous Service Queue. 

3-4, 20, 26-30, 33, 35, 41, 146, 147 

37 

34-38, 45 

40 

61-63 

3, 49, 64 

42, 121, 141 

68, 74, 78, 91, 94, 101, 104-106, 115, 

117, 120 

39, 40, 67, 68, 74, 78, 80, 87, 91, 

94, 95, 101, 102, 104-106, 109, 115, 

117, 119, 138 

96, 98-100 

87 

74-75, 79, 85 

74, 79, 85 

24 

9 

24, 48 

8 

3, 49, 58, 64, 66, 82, 132 

74, 79, 82, 131 

41, 43, 44, 60, 73, 78, 83, 88, 89, 
96, 99, 122, 124-126, 128-131, 133, 
135, 137, 143 

44, 57, 60, 88, 126, 129, 132, 137, 
143 

33, 45 

50, 60, 157 

50, 60, 56, 157 

38 

58, 59 
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calling sequence 
calling task 
Cancel function 
catalog 

catalog name 

CFGA 

chain file 

change attributes mechanism 

change parameter mechanism 

Change-Access-Permission function 

Change-LUN-Assignment function 

channel 

channel error 

channel type code 

Checkpoint function 
checksum 
Close function 
command level syntax 
completion-address field 
condition code 
Configuration Area (CFGA) 
Configuration-Status function 



Configuration/Status Block (CSB) 
Configure- and-Dismount 
Configure- and-Mount 
Configure-Defaults function 



Configure-Device function 



Configure-Only function 

Connection-Wait function 

console 

contiguous allocation 

Continue function 

control characters 

controller 

Copies function 

Create Task Control Block (CRTCB) 

CRT 

CRTCB 

CSB 

Current function 

current configuration 

current record pointer 
cylinder number 



145 

3, 23, 33, 37, 44, 49, 61, 62, 146-148 

3, 23, 24, 45 

4-7, 19, 24, 25, 28, 34, 39, 42, 112, 
151, 153 

4, 5, 18, 19, 28, 33, 34, 36, 37, 41 
See Configuration Area. 

5 

68 

67 

3, 15, 20, 35 

3, 21, 23, 44 

2, 144 
59, 135 

40, 70, 74-76, 91, 93, 101-105, 115- 
116 

3, 17, 20, 38 
58 

3, 20, 37, 38, 45 

6 

61 

26, 57, 63, 64 

8 

3, 40, 52, 66, 68, 70, 71, 73, 76-87, 

92-100, 102-111, 116-118, 132, 133, 

141, 159 

40, 68, 69, 71, 137-141 

72, 137, 139-141, 143 

72, 137, 138, 140, 141, 143 

3, 53, 66, 68, 70, 71, 73, 75-87, 

92-100, 102-111, 116, 118, 132, 133, 

140, 163 

3, 52, 54, 56, 66, 68-71, 73, 75-87, 

92-100, 102-111, 118, 119, 132, 133, 

159 

138, 143 

3, 56, 61 

26, 48, 153 

9 

3, 23, 24, 46, 47, 100, 153 

10, 131 

59, 114, 134, 136, 144 

3, 23, 25, 48, 153 

145-147 

2, 62 

See Create Task Control Block. 

See Configuration/Status Block. 

11, 122, 124, 126, 128 

8, 66, 68, 70, 71, 73, 79, 95, 104, 
132, 141 

11, 12, 21, 33, 60, 122-126, 128 
101, 105, 109, 110 
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data block 

data block length error 
data block size 
data buffer 

data management 
data transfer 



debug 

DEF command 

default configuration 

default user catalog 

default values 

default volume ID 

Delete-Record function 

density requested 

device code 

device configuration 

device driver 

device status word 

device type code 

device type error 
device-dependent error 
device-independent errors 
direct-access device 
directory 

disk configuration parameter block 

disk controller 

disk controller attribute table 

disk data structure 

disk drive 

disk file description 

disk storage 

DMA 

DORMANT state 

driver (type) code 

duplicate filename 
duplicate keys 

ECC data burst 

ECC error 

echo 

emulator module 

EOL character 

Erase function 

erasures 

error condition code 

error correction 



27, 29-33, 42, 58, 60, 120, 123-126, 

128, 129 

32 

29-33, 42, 123, 124, 126, 128 

33, 57, 65, 96, 99, 122, 124-126, 128- 

132, 135 

1 

4, 12, 37, 50, 51, 53-56, 58, 60-63, 
73, 96, 98, 99, 127, 130, 131, 133, 
135, 143, 157 

5, 76 
16 

66, 70, 73, 140 
6 

6, 28, 140 

6, 28 

3, 12, 37, 51, 65, 126-129 

115, 116, 118-120, 138 

40, 121, 123, 127, 129, 132 

40 

67 

64 

40, 70, 71, 74, 77, 91, 93, 101, 103, 

115, 117, 120 

32, 37 

57, 58, 122, 128, 132, 133, 135 

57 

27, 28, 30-32, 38 

3, 8, 9, 17, 27, 31-33, 36-38, 41, 43, 

151 

8, 100 

7, 103, 106-112, 114, 134, 136 
114 

4 

66, 112 

4 

8 

59 

145 

70, 74, 75, 77, 91, 92, 94, 101, 103, 

115, 120 

27, 31, 32, 36 

9, 20, 29, 32, 40, 43, 127, 129 

101, 103, 105, 111, 120 

111 

55, 78, 87-89 

5 

92, 98-100 

116 

115, 118, 120, 139 

64 

54 



169 



MICROSYSTEMS 



(g) MOTOROLA 



INDEX 



error message 
execution status 
EXORmacs 
extension 



FAB 

FAB SIZE 

family names 

FCB 

FDC 

Fetch-Default-Volume function 

Fetch-Device-Mnemonics function 

Fetch-Directory-Entry function 

FHS parameter block 

File Access Block (FAB) 

file assignment 

File Control Block (FCB) 

file descriptor error 

file formats 

File Management Service (FMS) 

file protection codes 

fixed length record 

fixed protection 

Floppy Disk Controller (FDC) 

floppy disk devices 

floppy disk driver 

FMS 

Format function 

formatted mode 
formatting 
Forms function 
function validity tests 

General Purpose Interface Bus (GPIB) 
GPIB 

Halt-I/0 

hard copy device 
hard disk devices 
hard disk driver 

I/O channel 

I/O device 

i/o driver 

i/o error 

image mode 

INCLUDE files 

indexed file 

indexed sequential files 



11, 139, 143 

57 

76, 93 

4, 5, 7, 8, 18, 19, 24, 25, 28, 31, 

33-37, 39, 41, 42, 151, 153 

See File Access Block. 
29, 32, 33, 42 

7, 41 

See File Control Block. 

See Floppy Disk Controller. 

3, 21, 22, 27, 28, 45, 151 

3, 21, 22, 43, 152 

3, 7, 21, 30, 41, 151 

18, 19, 34, 35, 39, 42, 43, 132, 

146, 147 

8, 9, 27, 29, 32, 33, 42, 58, 126, 129 
2, 33 

33, 34 

27, 32, 34, 36, 37 

2, 9 

10, 29, 35, 38, 124 

14 

10, 124, 126, 128 

13 

136 

136 

121, 123, 127, 129 

See File Management Service. 

3, 49, 51, 54, 55, 57, 65, 56, 135, 
136 

56, 73, 87, 89, 96, 98, 99 
55, 99, 111, 121 
3, 23, 25, 46-47 
53 

58 

See General Purpose Interface Bus. 



3, 39, 52, 62, 


63, 


130-133, 136, 


142, 


144, 158 








87 








134 








121, 123, 127, 


129 






117 








52 








53 








32, 34, 36-38, 


43, 


46-48 




54-56, 73, 89, 


96, 


99 




5 








38 








9, 10, 29, 32, 


55, 


127, 129 
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INIT utility 

initialization 

Input/Output Control Block (lOCB) 

insufficient directory space 
insufficient space 
insufficient system space 
Intelligent Peripheral Controller 

(IPC) 
interactive device 
interactive terminal 
interleave factor 
interrupt 

intertask function 
invalid command 
invalid data buffer 

invalid file type 

invalid function code 

invalid parameter block address 

invalid taskname 

lOCB 

IPC 

IPC disk configuration 

TPC rlv-ii/pv 

IPC printer 

key length error 
key size 
key value 

length-of-data-transfer field 

LIB 

line printer 

linkage 

linkage editor 

linker 

load module 

loader 

Loader Information Block (LIB) 

loader parameter block 

loadpoint 

Local -Break-Cl aimer function 

logical ending address 

logical EOF 

logical record length 

logical sector 

Logical Sector Number (LSN) 

logical unit assignment 

Logical Unit Number (LUN) 

LSN 

LUN 

LUN error 

LUN validation 



8 

5, 8, 11, 14, 32, 73 

49, 50, 62, 68-71, 91, 92, 101, 102, 

115, 116, 137-141 

27, 32 

31 

27, 33, 34, 45, 125, 128 

100 

22, 39, 44, 65, 66 

40, 62, 130 

101, 102, 105, 108, 120 

58, 144 

44 

27, 32, 58 

43, 44, 57, 65, 122, 126, 128, 132, 

133, 135 

27, 32 

51 

27, 32, 57 

27, 45 

See Input/Output Control Clock. 

See Intelligent Peripheral Controller. 

100 

77, 94, 103 

93 

32 

29, 32, 42, 128 

12, 55 

60 

See Loader Information Block. 

39, 40, 132 

5 

145 

5 

1, 146 

1, 9, 145-148, 165, 166 
9, 145, 147, 148 

145, 148 

118, 119, 137, 138, 142, 143 

52, 64, 157 

30 

122 

29, 31, 39, 42 

7, 9, 12, 42, 124 

9 

2, 43, 45, 66 

2, 4, 16-18, 27, 59 

See Logical Sector Number. 

See Logical Unit Number. 

34-38, 45 

53 
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M420 


103 


magnetic tape 


39, 40, 58, 71, 72, 115-117, 119, 120, 




136, 142, 144 


magnetic tape driver 


116, 117 


mask bit 


68, 71, 104 


MCCM 


See Multi -Channel Communications 




Module. 


media attribute table 


112, 113 


memory buffer 


137 


Memory Management Unit (MMU) 


19, 51 


MMU 


See Memory Management Unit. 


modem operation 


75, 88 


monitor 


61, 63, 146, 147 


Multi-Channel Communications Module 




(MCCM) 


60, 76, 93 


multiple logical unit 


16 


multiple write assignments 


33, 125 


multitasking 


2, 61 


MVMElOl 


76 


MVMEllO 


76 


MVME115 


76 


MVME120 


76 


MVME315 


103, 134, 136 


MVME320 


103, 134, 136 


MVME400 


76 


MVME420 


134, 136 


MVME435 magnetic tape adapter 


116 


Negate-Local-Break-Claimer function 


52, 64, 160 


non-contiguous file 


12, 29, 31, 33, 40 


non-direct-access device 


27, 28, 30, 34, 36-38, 40 


non-spooler filename 


24, 47 


NUL character 


99 


null padding 


74, 79, 86, 120 


number heads 


101, 120 


number of cylinders 


101, 105, 106, 108-110 


number of read tries 


115, 139 


number-of-copies parameter 


47, 48 



offset 

Output-with-Input function 
overflow 

overwrite option 

parameter block 



parameter block address 
parameter block length 



60, 101, 105, 108, 120, 125, 138-140, 

146, 147 

3, 51, 54-56, 50, 65, 81, 118, 131 

44, 57, 60, 89, 126, 129, 132, 137, 

143 

21, 33 

1, 16, 18, 19, 22-26, 28, 30, 34, 35, 

39, 41, 44, 49-51, 53, 57, 61-64, 66- 

71, 73, 79, 88, 91, 95, 100, 104, 111, 

119, 125, 132, 137-141, 143, 145-147, 

158, 164 

18, 51, 69, 145 

53 
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parameters mask field 

parity usage 

Pascal 

password 

peripheral attributes 

peripheral controller 

permission error 

physical printer line 

physical record length 

Physical Sector Number (PSN) 

physical sector size 

PIA port 

pointer 

poll 
port 

Position function 

precompensation value 

Print 

printer 

printer attributes word field 
printer configuration block 
Prior 

private files 
privileged access 
privileged requests 
privileged task 
program address space 
program loader 
Protect function 

protect error 
PSN 

Queue function 
queue entry 

random access 
random access device 
random access files 
random key 
random key access 
read buffer 
Read function 



read terminators 
read timeout 

read-protect code 



67, 75, 91 

78 

5 

7, 11 
49 
100 

32, 34-37 

96 

29, 39 

7-9, 26, 54, 65, 66, 135 

101, 105 

94 

8, 11, 12, 21, 22, 30, 33, 41, 43, 60, 
122-126, 128, 151, 152 

61 

40, 60, 73, 76, 77, 89, 90, 93, 94, 

132 

3, 11, 21, 49, 52, 60, 123, 125-128, 

157 

101 

3 23 25 47 94 

22, 39, 40, 62, 66, 72, 91, 93-100, 

120 

100 

91 

11, 124, 126, 128 
7 

53 

51, 53 

36, 37, 148 

50, 69 

1, 145 

3, 7, 14, 20, 27, 29, 32-37, 39, 45, 

57 

32, 34-37, 58 

See Physical Sector Number. 

3, 23, 26, 48 
46, 48, 61 

12, 38, 56, 122, 125 
3, 22, 44, 66, 100 

7 

126-129 

60, 129 

73 89 

3,'l2, 14, 49, 51, 54-56, 60, 67, 75, 

81, 83-86, 107, 116, 118, 122, 124, 

126-129, 131, 134-137, 140, 143, 144 

67, 74, 79, 84, 86, 120 

70, 74, 79, 81, 101, 105, 107, 115, 

116, 118, 120, 140 

7, 18, 33, 35 
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receiving buffer 
record format 
record length 

record length error 

relocatable object modules 

Rename function 

REPAIR (utility) 

reserved field zero 

reset 

reset condition 

Retrieve-Attributes function 

Retrieve-Next 

return address 

Rewind function 

rewrite 

RWIN 

RWINl 

SAT 

Search 

secondary directory block 

Sector Allocation Table (SAT) 

sector boundary 

segment boundary 

segment physical address 

segment size 

sequential access 

serial device drivers 

serial port 

session 

session manager 

shared data buffer 

shared segment 

shared segment error 

shared segment option 

size error 

size field 

SMD 

space allocation 

Space-Forward 

Space request 

Space-Reverse 

spiral offset 

spooler default volume 

spooler device 

spooler file 

spooler file volume 

spooler filename 

spooler queue 

spooler task 



22, 30 
3 

10, 18, 19, 29, 31, 32, 34, 35, 39, 
125, 125, 128, 129, 151 

27, 32 

5 

3, 14, 20, 28, 36 

7, 8 

53 

39, 70, 132 
70 

21, 27-29, 38, 44, 51, 132, 151 

130 

61 

3, II, 49, 52, 116, 121-123, 125, 127, 

142, 143, 157 

143 

103 

134, 136 

See Sector Allocation Table. 

116 

9 

8 

122, 135 

148 

20 

30 

11, 12, I2I-I25, 134, 135 
67 

40, 60, 73 

5, 6, 22, 23, 48, 146-148, 152 
6 

20, 21 

20, 30, 34, 37, 45, 123, 124, 126, 
128, 129 

27, 34, 45 

21, 30, 33, 34, 123, 124 
27, 31 

26, 29, 30, 40, 43, 111 

See Storage Module Drives. 

8 

118, 119, 142, 143 

9, 116 

118, 119, 142, 143 

101, 105, 108, 120 

22 

34, 46-48, 70 

6, 32, 34, 46, 124, 125 
6 

16, 24, 25, 47 

3, 17, 23, 25, 47, 48 

6, 23, 46-48, 153 



174 



MICROSYSTEMS 



® 



MOTOROLA 



INDEX 



spooling 

standard lOCB parameter block 

starting head number 

starting logical address 

stepping rate 

stop bit 

Storage Module Drives (SMD) 

string 

supervisor task 

suspend task 

SYMbug 

syntax 

syntax error 

SYSGEN 

system buffers 

system failure 

system files 

system generation 

system task 

system volume 

tape density 

tape drive 

Task Control Block (TCB) 

task queue 

task session 

TCB 

teletype configuration 

temporary file 

temporary file volume 

terminal 



terminal code 

terminal screen 

terminator-class 

Test-I/O-Complete 

text editor 

timeout for search 

timeout for space forward 

timeout for tape read 

toggle 

track 

Transmit-Break 
transport density 
TRAP #2 
TRAP #3 
TRAP #4 
type-ahead buffer 



34, 39, 70 

49, 50 

101, 105, 109, 120 

30, 34 

101, 105, 110, 120 

78, 88 

109, 112 

4, 16, 74, 79, 80, 84, 85, 131 
53 

3 
5 

1, 57 
32, 34 

3, '5, 49, 66, 70, 73 

38 

38 

6, 7, 11 

2, 59 (See also SYSGEN.) 

7, 26, 27, 44, 45, 57, 70, 146, 148 

6, 31, 35 

72, 137, 141 

72, 138, 140, 141, 143 

146 (See also CRTCB.) 

61 

23, 152 

See Task Control Block. 

130 

5, 6, 16, 35, 37, 45 
6 

14-16, 32, 33, 40, 54, 56, 62, 65-68, 

72-74, 77, 79, 80, 82, 83, 87-89, 120, 

130, 131 

74, 87 

80 

74, 79, 86, 120 

52, 64 

2 

115, 120 

120 

115, 116, 120 

83 

7, 54, 65, 66, 102, 104-108, 110-112, 
134, 135 

51, 66 
72, 137 

3, 4, 40, 63, 155-164 
3, 18, 149-153 

1, 145, 165, 166 
54, 89 
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UDC 

Universal Disk Controller (UDC) 

update configuration 

Update-Record function 

user file 

user logon 

user number 

user session management 
user task 

user validation file 
variable length record 



See Universal Disk Controller. 

134, 136 

78, 79, 94, 95, 104, 105, 117 

3, 12, 51, 65, 123, 125-129 

4, 6 
6 

4-8, 11, 18, 19, 24-28, 31-37, 39, 41, 

42, 46-48, 151, 153 

6 

2, 13, 53, 146, 148 

7, 11 

10, 29, 31, 60, 126-130, 133 



VERSAdos 


1, 2, 4, 6-8, 11, 101, 105-108, 115, 




117, 121 


VERSAdos sector 


101, 105-108, 115, 117 


VID 


See Volume Identification Block. 


VMOl 


76, 93 


VM02 


76 


VM03 


76 


VM04 


76 


VM20 


106, 107 


VM21 


100, 106, 107 


VM22 


103, 134, 136 


VM80 


76 


VME/10 


76, 77, 87 


volume error 


27, 31, 32, 34, 37 


volume ID 


5, 6, 8, 28, 34, 35, 37, 39, 41, 44, 




45 


Volume Identification Block (VID) 


8 


wait state 


56 


Wait-Only 


38, 52, 61, 62 


Winchester controller board 


134, 136 


word boundary 


19, 50, 60, 69 


Write function 


3, 12, 14, 15, 33, 49, 51, 54-56, 60, 




65, 80, 81, 83, 85, 




97, 106, 116, 118, 122-131, 133, 135- 




137, 143 


write timeout 


67, 74, 79, 81, 91, 95, 97, 101, 105, 




105, 115, 116, 118, 120, 133, 140 


write tries 


115, 120, 139 


Write-Next 


125, 130 


Write-Prior 


130 


write-protect code 


13, 15, 18, 33, 35, 37 


write-protected 


13, 14, 44, 58, 60, 72, 122, 126, 128, 




141 



XOFF/XON characters 



74, 79, 82, 88, 89, 120 
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